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Fisrt Edition (December 1984) 

Use this publication only for the purposes stated in the following section entitled 
"About This Book." 

Changes are made periodically to the information herein; any such changes will be 
reported in subsequent revisions or Technical Newsletters. 

This material may contain reference to, or information about, IBM products 
(machines and programs), programming, or services that are not announced in your 
country. Such references or information must not be construed to mean that IBM 
intends to announce such IBM products, programming, or services in your country. 

Publications are not stocked at the address given below. Requests for copies of IBM 
publications should be made to your IBM representative or the IBM branch office 
serving your locality. 

This publication could contain technical inaccuracies or typographical errors. A form 
for readers' comments is provided at the back of this publication. If the form has 
been removed, address your comments to IBM Corporation, Information 
Development, Department 28B, P. O. Box 1328, Boca Raton, Florida 33432. IBM 
may use or distribute any of the information you supply in any way it believes 
appropriate without incurring any obligation whatever. You may, of course, continue 
to use the information you supply. 

© Copyright Intemational Business Machines Corporation 1984 
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Summary of Changes for Version 5.0 






The following additions and changes have been made to this document: 

Chapter 3 has been updated to include the IBM product diskettes for Version 5. 

Chapter 4 has been updated to include the Remote Support Link requirements. 

Chapter 5 has been updated to reflect Version 5 changes to $EDXDEF and product 
diskettes. 

Chapter 6 has been updated to include migrating to Version 5. 

Appendix A has been updated to include the Remote Support Link requirements. 

Appendix D has been updated to include new supervisor module names. 

Miscellaneous editorial changes have been made also. 



Summary of Changes for Version 5.0 iii 
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About This Book 



This book is a guide for installing the Event Driven Executive on your Series/ 1 and for 
generating a tailored operating system to meet your application requirements. It contains 
step-by-step procedures for installation and system generation tasks. 






Audience 



This book is intended for anyone who has to install the Event Driven Executive on an IBM 
Series/ 1 and to create an operating system to meet application requirements. Readers should 
have a basic understanding of computer terminology before using this book. 



How This Book Is Organized 



This book is divided into the following 6 chapters and 5 appendices. 

• Chapter 1, Prepare for Installation and System Generation, contains an overview of the topics 
covered in this book. 

• Chapter 2, Determine If the Starter System Meets Your Needs, describes the I/O devices and 
software features supported by the starter system, an IBM-supplied operating system. 

• Chapter 3, Install EDX, provides the step-by-step procedures for installing the Event Driven 
Executive system on your IBM Series/ 1 . 

• Chapter 4, Select Your Required Support, describes how to select the support (hardware and 
software features) you need for your application. 



About This Book 



About This Book 



How This Book Is Organized (continued) 



Chapter 5, Generate a Tailored Operator System, provides the step-by-step procedures for 

generating a tailored operating system. 

Chapter 6, Migrate to Version 5, provides the migration procedures used to convert from edx 

Versions 1 and 2 to EDX Version 5. 

Appendix A, System Definition Statements, contains the system definition statements used to 

define I/O devices to your operating system. 

Appendix B, Customizing Adapters with Hardware Jumpers, contains information about 

jumper connections on several adapters. 

Appendix C, 3101 Configuration Information, contains planning information to use in setting 

up and defining 3101 display terminals to your operating system. 

Appendix D, Supervisor Module Names (CSECTS), contains a listing of all supervisor module 

names and entry point labels. 

Appendix E, Work Sheets, contains four work sheets. Use work sheet 1 to estimate your 

storage requirements and the partition structure of processor storage. Use work sheet 2 to 

define the processor storage characteristics and the I/O devices attached to your Series/ 1. 

Use work sheet 3 to define the software features you require to support the I/O devices you 

defined in work sheet 2 and the EDX-related products you include in your system. Use work 

sheet 4 to estimate the size of supervisor partitions and programs executing in partitions 

other than partition one so that you can define the structure of processor storage. 



Aids to Using This Book 



This book contains the following aids to using the information it presents: 

• A table of contents that lists the major headings in this book. 

• An index of the topics covered in this book. 

• A glossary that defines terms and acronyms used in this book and in other EDX library 
pubUcations. 

In the step-by-step procedures shown in Chapters 3 and 5, several utilities are used and the 
interactive display screens are shown. Any responses you must make to a system prompt are 
shown in red. 



A Guide to the Library 



Refer to the EDX Library Guide and Common Index for information on the design and structure 
of the Event Driven Executive library, a bibliography of related publications, and an index to the 
entire library. 
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Contacting IBM about Problems 



You can inform IBM of any inaccuracies or problems you find when using this book by 
completing and mailing the Reader's Comment Form provided in the back of the book. 

If you have a problem with the Series/ 1 Event Driven Executive services, fill out an authorized 
program analysis report (apar) form as described in the IBM Series/ 1 Software Service Guide, 
GC34-0099. 



^%, 
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Chapter 1. Prepare for Installation and System 

Generation 






This chapter outlines what you need to do to install the Event Driven Executive (edx) or create 
a tailored operating system. 

EDX is shipped to you on a series of product diskettes that contain a basic supervisor program 
and related support. The basic system supports certain hardware devices and software features. 
If the hardware devices and software features supported by this system match your application 
needs, you can install it as your operating system. 

If you have hardware devices attached to your Series/ 1 that are not supported by the supplied 
system, or if you require software features that it does not include, you must generate a tailored 
operating system. 



What Do You Need To Do? 



Once you receive the Program Directory i and the product diskettes, you need to: 

Migrate to Version 5 from Versions 1 and 2 (Chapter 6). 

Determine if the supplied system meets your requirements (Chapter 2). 

Install EDX (Chapter 3). 

Select your required support (Chapter 4). 

Generate a tailored operating system (Chapter 5). 



The Program Directory is a set of installation procedures and instructions shipped with the product 
diskettes. 
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Prepare for Installation and System Generation 

What Do You Need To Do? (continued) 

Migrate to Version 5 (Version 1 and 2 Only) 

Before installing the EDX Version 5, you must convert Versions 1 and 2 data sets to make them 
compatible with Version 5 data sets. The conversion procedures to migrate from Versions 1 and 
2 are described in Chapter 6. 

Note: If you are a current user of EDX Versions 3, 4.0, or 4.1 and are migrating to EDX Version 
5, you do not have to perform a special conversion procedure. Versions 3, 4.0, 4.1, and PTF 
P02 programs and data sets are compatible with Version 5. However, we suggest that you 
create a backup copy of your current system and pertinent data before installing EDX Version 5. 

Determine if the IBM-Supplied System Meets your Requirements 

The information in Chapter 2 helps you decide if the IBM-supplied system meets your 
application needs. If it does, you can use it as your operating system. If it does not, you must 
generate a tailored operating system. 






install EDX 



EDX is supplied to you on the product diskettes. To install edx on your Series/ 1, you must copy 
these diskettes to your disk. The installation procedure varies, depending on the model 
processor you have on your system. 

Chapter 3 describes the installation procedure for systems with a 4952, 4954, 4955, or 4956 
processor. If you have one of these processors, you need to perform the following steps to 
install EDX: 



^¥"^ 



Migrate to Version 5 (Version 1 and 2 users only). 

IPL the supplied system from diskette. 

Allocate and initialize disk volumes. 

Copy the product diskettes to your disk. 

IPL the system from disk. 

Verify your installation using an IBM-supplied program. 



^kt^-^ 
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What Do You Need To Do? (continued) 

Select Your Required Support 

The information in Chapter 4 helps you select the system features you need to generate a 
tailored operating system. This task consists of defining the structure of processor storage, 
defining the I/O devices attached to your Series/ 1 , and selecting the system features required 
for your application. 

The following work sheets are provided to help you keep track of your selection: 

Work Sheet 1 Estimating the size of your supervisor 

Work Sheet 2 Defining I/O devices to the supervisor 

Work Sheet 3 Selecting software support 

Work Sheet 4 Estimating the size of supervisor portions and programs executing in partitions 
other than partition one. 

After you finish selecting the devices and features and filling out the work sheets, you can take 
these work sheets and this book to your Series/ 1. Then you can follow the procedures in 
Chapter 5 for generating a tailored operating system. 

Generate a Tailored Operating System 

"\ 

Chapter 5 provides the steps you need to generate a tailored operating system. This means you 
must modify a copy of the EDX supervisor which is part of the iBM-suppUed system. This 
process consists of the following tasks: 

1 . Creating a set of system definition statements reflecting the hardware configuration of the 
system on which the tailored operating system will run. 

2. Selecting the supervisor object modules that are required to support the desired I/O devices 
and system features. 

3. Assembhng the system definition statements created in Step 1 above. 

4. Link editing the object modules produced by the assembly in Step 3 with the supervisor 
object modules selected in Step 2 to produce a modified supervisor. 

5. Initializing your new supervisor. 

6. iPLing your system. 

7. Verifying your operating system. 
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Notes 
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Chapter 2. Determine If the IBM-Supplied 

System Meets Your Needs 






The information in this chapter helps you determine if the configuration of the IBM-supplied 
system meets your needs as an operating system. You can use this system configuration to 
define your operating system only if the devices you have and the software features you need 
match the devices and software that are built into the IBM-supplied system. 

If you have any devices that aren't built into the iBM-suppUed system (such as magnetic tape or 
two 4964 diskette units), you must "tailor" your operating system. You must also "tailor" your 
operating system if you need any software features that aren't built into the IBM-supplied system 
(such as floating point, error logging, spooling, or timers). 

Tailoring your operating system means building your needs into an operating system. The task 
of tailoring your operating system involves adding I/O devices and software features that are 
not supported in the IBM-supplied system configuration as well as deleting from it the I/O 
devices and software features that you do not need. The system supplied on the product 
diskettes is one of the tools you need to tailor your own operating system. Therefore, you must 
install it even if you cannot use it as your operating system. 
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Determine If the IBM-Supplied System Meets Your Needs 



What is the IBM-Supplied System? 

The IBM-supplied operating system, $edxnuc, supports up to 512K bytes of storage (depending 
upon your processor) and has eight partitions defined. A maximum of five programs can 
execute in each partition at the same time. In addition, the IBM-supplied system supports certain 
I/O devices and software features. 

As received from IBM, $EDXNUC contains special supervisor modules that allow it to run on any 
Series/ 1 with the minimum system configuration. You should not use these modules in a 
production environment. Therefore, even if your hardware configuration is supported by the 
IBM-supplied system, you must generate a tailored system, using the supplied defaults. 

Configurations for $EDXNUC 

The following sections outline the hardware and software supported by the basic supervisor 
$EDXNUC. 

Devices Supported by $EDXNUC 

The starter system for the 4952, 4954, 4955, and 4956 processors ($edxnuc) supports the 
following I/O devices: 

One 4962, 4963, or 4967 disk storage unit 

or 

One 30-megabyte disk within a 4952, 4954, or 4956 Model SOD processor or within a 4965 
storage and I/O expansion unit (model 30D) 

or 

One 60-megabyte disk within a 4954 or 4956 Model 60D processor or within a 4965 storage 
and I/O expansion unit (model 60D) 

plus 

One 4964 diskette storage unit 

Two 4965 diskette storage units 

One 4966 diskette storage unit 

One 4978, 4979, or 4980 Display Station 

One Teletypewriter ^ (TTY) device 



Trademark of Teletype Corporation 



\^ 
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What is the IBM-Supplied System? (continued) 

One 4974 printer 

One Multifunction Attachment (MFA) - Feature Number #1310 

One Multidrop Work Station Attachment - Feature Number #1250 

One 4975-OlL and one 4975-02L printer attached via the Multifunction Attachment 

One 3101 Display Terminal (block mode) locally attached at 1200 bits/second via the 
Multifunction Attachment. 

Notes: 

1. If there is no Multifunction Attachment, $edxnuc expects a 3101 Display Terminal (block 
mode) attached point-to-point at 1200 bits per second and range high via adapter #1610. 
(For information on customizing adapters, see Appendix B, "Customizing Adapters with 
Hardware Jumpers" on page IS-243.) 

2. If there is no #1610 adapter, $edxnuc expects a 3101 Display Terminal (block mode) 
attached via adapter #2091/2092. 

3. If there is no #2091/2092 adapter, $edxnuc expects a 3101 display terminal (block mode) 
attached via adapter #2095/2096. 

\^ Software Features Supported by $EDXNUC 

$EDXNUC provides the following software support: 

• Initialization and operational support for supported devices 

• Relocating program loader 

• #1310, 2095/2096, 7850 acca/tty translation 
. # 1 6 1 0, 209 1 / 2092 ACC A translation 

• A 256-byte supervisor patch area 
. MINMSG support. 

• Error logging. 
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Determine If the IBM-Supplied System Meets Your Needs 

What is the IBM-Supplied System? ^coi7t//7c/e£/; 



Devices Not Supported by $EDXNUC 



The Series/ 1 devices in the following checklist are not supported by the basic starter system 
($EDXNUC). Use the checklist below to indicate the I/O devices attached to your Series/ 1. If 
any of these devices is part of your system, you need to generate a tailored operating system. 



Device 


Yes 


No 


4968 Magnetic Tape Subsystem 






4969 Magnetic Tape Subsystenn 






4973 printer 






5219 printer 






5224 printer 






5225 printer 






2741 Connmunications Terminal 






General Purpose Interface Bus 






Binary Synchronous Line 






Synchronous Communications Single-Line 
Control /High Speed Feature (#2080) 






Series /I -to- Series/ 1 Attachment (RPQ D02441 or 
D02242) 






Timer Feature #7840 






An ASCII terminal attached via feature #1610, 
#2091 /2092, or #2096/2096 






4975-01 A ASCII Printer 






Integrated I/O Nonisolated Feature (#1560) 






Printer Attachment - Series 5200 (#5640) 






4982 Sensor I/O Units 






More than two 4965 diskette units 






Virtual Terminal option 






Other I/O devices attached to the Series /I 







o 



Figure 1. Checklist of Devices Not Supported by the Starter System ($EDXNUC) 
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What is the IBM-Supplied System? (continued) 



You also need to generate a tailored operating system if your system contains multiples of the 
following devices: 



Device 


Yes 


No 


4962 disk 






4963 disk 






4967 disk 






30-megabyte disk 






eO-megabyte disk 






4964 or 4966 diskette units 






4978, 4979, or 4980 display terminals 






3101 display terminal 






TTY 







Figure 2. Checklist of Devices Not Supported by the Starter System ($EDXNUC) 



Software Features not Provided by $EDXNUC 



The software features in the following checklist are not supported by the starter system 
(edxnuc). Use the checklist to indicate the features you require for your application. If you do 
require any of these, you need to generate a tailored operating system. 



Software Features 


Yes 


No 


No overlay support 






Multiple wait support 






Queue processing support 






Binary synchronous communications support 






Timer support for the 4955 processor 






EXIO support 






EXIO trace option 






Unmapped storage support 







Figure 3 (Part 1 of 2). CheckUst of Software Not Supported by EDXNUC 
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Determine If the IBM-Supplied System Meets Your Needs 

What is the IBM-Supplied System? (continued) 



Software Features 


Yes 


No 


Host communications support 






Minimum message support 






ACCA trace option 






Indexed Access Method QCBs 






Translation tables for 2741 terminal 






Timer support for the 4952/4954/4956 processor 






Software support modules for the I/O devices listed 
under "Devices Not Supported by $EDXNUC" on page 
IS-8 






1024 bytes/sector IPL capability and/or I/O support 






Interprogram communications via virtual terminals 






Spooling support 






EBCDIC/floating-point conversion 






Floating-point arithmetic 






Remote Management Utility 






Interactive debug 






Virtual Terminal option 










Figure 3 (Part 2 of 2). Checklist of Software Not Supported by EDXNUC 
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Chapters. Install EDX 



This chapter describes two things. First, it describes what you need to install the Event Driven 
Executive (EDX) on a Series/ 1 with a 4952, 4954, 4955, or 4956 processor. Second, it describes 
the step-by-step procedures for installing EDX on one of these systems. 



X 

What Do You Need? 



To install EDX, you need the following: 

• The Program Directory 

• The product diskettes shipped to you from IBM containing the following program library: 

— Basic Supervisor and Emulator (5719-XS5). 

— Any of the following program products depending on your installation requirements: 

— Program Preparation Facility (5719-XX6) 

— EDX Macro Library (5719-LM9) 

— EDX Macro Library/Host (5740-LM6). 

• A Series/ 1 with one of the following minimum configurations, dependant on the processor 
installed on your system: 

— If you have a 4952, 4954, 4955 (except models A and C), or 4956 processor, you need 
the following minimum configuration: 
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Install EDX 



What Do You Need? (continued) 



One Processor (one of the following): 

— 4952, 4954, 4955 (except models A and C), or 4956 processor with 64KB of 
storage for a production system 

or 

— 4952, 4954, 4955 (except models A and C), or 4956 processor with 128KB of 
storage for a development system. 

One Disk storage unit (one of the following): 

— 4962 Disk Storage Unit. 

— 4963 Disk Subsystem. 

— 4967 Disk Subsystem. 

— 30-megabyte disk storage unit within a 4952, 4954, or 4956 model SOD 
processor or within a 4965 storage and I/O expansion unit (model 30D). 

— 60-megabyte disk storage unit within a 4954 or 4956 model 60D processor or 
within a 4965 storage and I/O expansion unit (model 60D). 

Note: The 30-megabyte disk is referred to as DDSK-30 and the 60-megabyte disk \^ 

is referred to as DDSK-60. 

One 4964 Diskette Unit, 4965 Diskette Drive, or 4966 Diskette Magazine Unit 

One 4974 Printer or 4975 Printer (attached through the Multifunction Attachment 
(MFA) Feature #1310) 

One Operator station (one of the following): 

— 4978 or 4979 Display Station. 

— 4980 Display Station attached through the Multidrop Work Station 
Attachment Feature #1250 at lOOK bits per second. 

— 3101 Display Terminal (character mode) or equivalent device attached 
through the Teletypewriter Adapter Feature #7850. 

— 3101 Display Terminal (block mode) attached point-to-point through Feature 
#1610, #2091/2092, or #2095/2096 at 9600 bits per second and high speed 
range. 

— 3101 Display Terminal (block mode) attached via a Multifunction Attachment 
Feature #1310 at 9600 bits per second in RS-422 mode. 
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^^% 

^ ^.y 



In addition, these devices must be at the following specified addresses: 



Device 


Type 


Address 
(Hex) 


4967 


Disk Subsystem 


48 


4964 


Diskette Unit 


02 


4965 


Diskette Drive 


44I 


4966 


Diskette Magazine Unit 


22 


4974 


Printer 


01 


4975-01 L 


Printer (via mfa) 


5A 


4975-02L 


Printer (via mfa) 


5B 


4978 


Display Station 


24 


4979 


Display Station 


04 


4980 


Display Station 


80 


#1250 


Multidrop Work Station Attachment 


80 


#1610 


Asynchronous Communications Single- Line Adapter 


082 


#2091 /2092 


Asynchronous Communications Multiline Adapter 


602 


#2095/2096 


Feature- Programmable Communications Adapter 


682 


#7850 


Teletypewriter Attachment 


003 


#1310 


Multifunction Attachment (mfa) 


58* 



Figure 4. Address Assignments for Minimum Series/ 1 Configuration 

Notes: 

1 . If the diskette unit is part of a 4952 model 30D processor, a 4954 or 4956 model 30D/60D 
processor, or a 4965 storage and I/O expansion unit (model 30D/60D), the diskette unit 
must be at address 45. 

2. Supports 3101 models 20, 22, 23 in block mode. 

3. Supports 3101 models 10, 12, 13, 20, 22, 23 in character mode. 

4. Supports 3101 model 23 in block mode at address 59. 
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What Do You Need? (continued) ^ 

Preparing to Install EDX 

Note: This discussion is limited to the Basic Supervisor and Emulator (5719-XS5) and the 
Program Preparation Facility (5719-XX6). The Macro Library (5719-LM9) and Macro 
Library /Host (5740-LM6) licensed programs are not addressed. 

Before you install EDX, your system must have one of the following disk units: 

4962 Model 1 or 2 
4962 Model IF or 2F 

4962 Model 3 or 4 

4963 Model 1 
4963 Model IF 
4963 Model 2 
4963 Model 2F 
4967 Model 2 
4967 Model 4 
DDSK-30 
DDSK-60. 

An Event Driven Executive supervisor must reside in a data set named $EDXNUCx (where x 

equals any alphameric character you wish to specify). As shipped from IBM, diskette XS5001 

contains a supervisor called the starter system in a data set named $EDXNUC. The first step in 

installation requires that you perform an IPL of the starter system from diskette XS5001. /f'"'"\ 

Therefore, the Series/ 1 must have one of the following devices wired as either the Primary or \ J 

Alternate ipl device: " 

• 4964 Diskette Unit at hardware address X'02' 

• 4965 Diskette Drive at hardware address X'44' or X'45' 

• 4966 Diskette Magazine Unit at hardware address X'22'. 

Notes: 

L If the diskette device is wired as the Primary ipl device, the disk device must be wired as the 
Alternate IPL device. 

2. If a 4966 is the IPL device, you can perform an ipl from diskette slot 1 only. 

The object of installation is to copy the programs and utilities supplied on the product diskettes 
to a disk device. Therefore, the Series/ 1 on which the starter system is being installed must 
have one of the following devices wired as the Primary or Alternate IPL device. 

• 4962 disk (any model) at hardware address X'03' 

• 4963 disk (any model) at hardware address X'48' 

• 4967 disk (any model) at hardware address X'48' 

• DDSK-30 disk at hardware address X'44' 

• DDSK-60 disk at hardware address X'44'. 



o 
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What Do You Need? (continued) 



Note: If the disk device is wired as the Primary IPL device, the diskette device must be wired as 
the Alternate IPL device. 

In addition, the starter system assumes that certain terminal devices are attached to the Series/ 1, 
and that they have specific address assignments. The Series/ 1 on which the starter system is 
being installed must have one of the following: 

• TTY device at hardware address X'OO' 

• 4978 display at hardware address X'24' 

• 4979 display at hardware address X'04' 

• 4980 display at hardware address X'80'. 

Also, the Series/ 1 may have a 4974 Printer at hardware address X'Ol', a 4975-OlL at hardware 
address X'5A', or a 4975-02L at hardware address X'5B'. If you have a 4973, you can use the 
RA command of the $termuti utility to reassign SSYSPRTR as follows: 



L 



RA SSYSPRTR x 



where x is the hardware address of your 4973. 






Installing EDX 



Note: The procedures and instructions for installing the Event Driven Executive are 
documented in the Program Directory, which is shipped with the licensed product diskettes. Late 
changes or updates to the installation process are reflected in the Program Directory. Therefore, 
you should use the Program Directory to install the EDX licensed programs. This discussion is 
limited to the major steps involved in installation. 

To copy the product diskettes and install EDX, you must do the following: 

Step 1 Save your existing system 

Current users of EDX Versions 1 or 2 must perform a special migration procedure 
outlined in Chapter 6, "Migrate to Version 5" on page IS-1 17. 

Current users of EDX Versions 3, 4.0, or 4.1 do not need to perform a special 
migration procedure. EDX Version 3, 4.0, or 4.1 programs are compatible with EDX 
Version 5. However, we suggest that you create a backup copy of your current 
system and pertinent data before instaUing EDX Version 5. 
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Installing EDX (continued) 



The following are some things to consider when you are deciding whether to make a 
backup copy of your system: 

• Are there any modified or special modules on the system such as: 

- A special $4978CS0 or $4980CSO on volume EDX002 for your own 4978 or 4980 
PF key definitions? 

- A special $edxl in asmlib for cf copy code, 370 Channel Attach, SNA, and 
so on. 

— Your own device initialization modules? 

— Modified EDX supervisor modules? 

• Do you have any session manager parameters saved? 

• Do you have a copy of your old $EDXDEFS, LINKCNTL, OR SUPPREPS? 

Step 2 IPL the starter system from diskette XS5001. 

Step 3 Initialize logical volumes EDX002, asmlib, EDX003, and FHVOL (for disks with fixed 
heads). 

Note: If you are a current user of EDX Version 3 , 4.0 or 4.1, you may not need to 
initialize these volumes. They were initialized when you installed your current system 
and already exist. However, see "Step 3 - Initialize Logical Volumes" on page IS-21 
for the recommended volume sizes. If your volumes are not large enough to contain 
the modules to be copied, you need to reinitialize them. 

Step 4 Copy the starter system ($edxnuC) and basic utilities. \^^ 

Step 5 IPL the starter system from disk. 

Step 6 Copy the system support modules and production utilities. 

Step 7 Copy the program preparation modules and utilities (this step is required if the 
Program Preparation Facility 5719-XX6 is being installed). 

Step 8 Exercise utilities and program preparation faciUties. 

Before you begin the installation process, you must have the following diskettes. 

Note: If you want to list the contents of the starter diskettes, use the $DISKUT1 utility as 
described in the Operator Commands and Utilities Reference. 



o 
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Installing EDX (continued) 



5719-XS5 Basic Supervisor and Emulator 




XS5001 
through 
XS5005 



5719-XX6 Program Preparation Facility 

r 







XX6001 

through 
XX 6004 



Diskette XS5001 contains the supplied starter system and the 
necessary utiUties to install the product. 

Diskette XS5002 contains supervisor object modules used during 
the system generation process. 

Diskette XS5003 is a multivolume diskette containing two 
volumes: XS503A and XS503B. Volume XS503A contains 
object modules that support various system functions. Volume 
XS503B contains utilities that are included with the supervisor. 

Diskette XS5004 contains the remaining utihties included with 
the supervisor. 

Diskette XS5005 contains the stand-alone dump program used 
for APAR reporting (for machines with 512 K or less storage). 



Diskette XX6001 contains the EDX program preparation 
modules. 

Diskette XX6002 contains copy modules for inclusion in user 
application programs. 

Diskette XX6003 contains copy modules for inclusion in user 
application programs. 

Diskette XX6004 contains the program preparation utilities and 
the session manager. 



You are ready now to install the Event Driven Executive. 
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Installing EDX (continued) 



Using EDX Utilities and Installation Procedures 



Throughout the installation procedures, several utility programs are used. In the examples of 
using these utilities, two types of messages are shown: a loading message and a prompting 
message. 

• You load a program by entering the command $L %utility where utility is the name of the 
utility being loaded. When the system loads the utility, it displays the following message: 

I LOADING name nP, HH.MM.SS, LP= nnnn, PART=x J 

Here, name indicates the utility being loaded. nP indicates that the utility is n number of 
pages long (256 bytes equals one page). hh.mm.sS equals the time in hours, minutes and 
seconds. LP= nnnn indicates the load point of the utility. part=x indicates the partition 
where the utility is loaded. With the exception of nP, the balance of the message changes 
depending upon where and when the utiUty was loaded. Due to these changes, the loading 
messages shown in the examples are for illustrative purposes only. 

• During installation, the utilities prompt you for information. In examples where a response 
is required, the response is highlighted in red. Enter the responses as shown in the example 
screens, unless you are instructed to do otherwise. 

The installation procedures are presented in step-by-step format. Each step has a brief /^A 

explanation of what you are supposed to do and an accompanying illustration. The illustration \_J 

shows switch settings or an example of the contents of your display terminal screen while you 
are performing the step. 



Step 1 - Save Your Existing System 



If you are migrating from EDX Version 1 or 2, follow the procedures outlined in Chapter 
6, "Migrate to Version 5" on page IS-1 17 before proceeding to Step 2. 

If you want to create a backup copy of all or part of your system and data, do so before 
proceeding to Step 2. The $MOVEVOL and $C0PYUT1 utiUty descriptions in the Operator 
Commands and Utilities Reference and the Operation Guide contain procedures for saving your 
EDX system and related data. 



o 
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Installing EDX (continued) 



Step 2 - IPL the Starter System 



2(a). Set the IPL Source switch and Mode switch to 
IPL from the diskette unit. 

The IPL Source switch has two positions. The 
primary position selects the primary IPL device 
for your system. The alternate position selects 
the alternate IPL device for your system. 
Depending on how your diskette drive is wired 
(Primary or Alternate), set the IPL Source 
switch as appropriate for your system. 

The Mode switch has three positions that 
allow you to select the mode in which you will 
operate: Auto IPL, Normal, and Diagnostic. 
Set the Mode switch to the Normal position. 

In the example, the diskette unit is the 
Alternate IPL device. As such, the IPL Source 
switch is set to Alternate. 





Load 


Wait 


Run 


b J 


[o j 


.0 , 









Alter Mdl.- 

Aulci 

Nornul 

Didgnosiit. 



y 

Mode 

8 



PowiT On 



_y 



tj 2(b). Insert diskette XS5001 into the diskette unit. 

EDX supports the 4964 and 4965 diskette units 
and the 4966 diskette subsystem. For 
instructions on inserting and removing 
diskettes from these devices, refer to the 
Operation Guide. 




2(c). Press the LOAD button on the Series/ 1 
console. 



Load 


Wait 


Run 


[o j 


lo J 


,0 J 



Alternate 
Ajici 

^OrTMl 

Diaqnusiir 







Power Oi' 






lo . 




On 
Oti 



J 
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Installing EDX (continued) 



When IPL completes, the following system IPL message is displayed on the logging device: 



*** EVENT DRIVEN EXECUTIVE ""* V5.0 
-** XPS 






IPL = $EDXNUC,XS5001 

XPS SYSTEM STORAGE MAP 



USER 


USER 


COMMON 


SUPV 


SUPV 


USER 


USER 


TOTAL 


PART START 


SIZE 


SIZE 


START 


SIZE 


START 


SIZE 


SIZE 


# (DEC) 


(DEC) 


(HEX) 


(HEX) 


(HEX) 


(HEX) 


(HEX) 


(HEX) 


1 i»76l6 


17920 








8A00 


BAOO 


i»600 


10000 


2 


65536 














10000 


10000 


3 


65536 














10000 


10000 


k 


65536 














10000 


10000 


TOTAL SIZES 


(HEX): 






BAOO 




3^600 




UNMAPPED STORAGE = 


(DEC) 2K E 


3L0CKS 









^ 



EDX INITIALIZATION COMPLETE 



The IPL message contains 9 columns. An explanation of each column follows. 

PART # Part # indicates the number of the partition. 

USER START The Starting address (in decimal) of the first program loaded for execution 

within each partition. 

USER SIZE The amount of storage (in decimal) within each partition available for 

program execution. 

COMMON SIZE The size (in hexadecimal) of the common area within each partition. 

SUPV START The starting address (in hexadecimal) of the supervisor within each partition. 

SUPV SIZE The size (in hexadecimal) of the supervisor within each partition. 

USER START The starting address (in hexadecimal) of the first program loaded for 

execution within each partition. 

USER SIZE The amount of storage (in hexadecimal) within each partition available for 

program execution. 

TOTAL SIZE The total size (in hexadecimal) of each partition. 



\^jy 
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Installing EDX (continued) 



Step 3 - Initialize Logical Volumes 



Before copying any data sets, you must write a volume directory on disk, allocate volumes, and 
create directories. 

You need to allocate and create directories for the following volumes: 

• EDX002 

• ASMLIB 

• EDX003 

• FHVOL (if your disk has fixed heads). 

Note; If you are a current user of EDX Version 3, 4.0, or 4.1 you do not need to initialize these 
volumes; they already exist on your system. However, you must ensure that they are large 
enough to install EDX Version 5. Use the $diskuti utility (lav command) to check the 
recommended volume sizes below and, if they are large enough, skip this step. 

If they are not large enough, you will need to reinitialize them. Remember to save any pertinent 
data before initializing the volumes; once the volumes are reinitialized, the data currently on 
them is no longer accessible. 

Note: Before installing a product, such as the Multiple Terminal Manager or Indexed Access 
Method, check the amount of space required for each. Refer to the appropriate program 
directories. 

The recommended size (in records) for each volume is as follows: 

Volume Size 

EDX002 10,000 

ASMLIB 10,000 

EDX003 15,640 

MACLIB 22,000 
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Installing EDX (continued) 



Steps 3(a) through 3(g) show you how to allocate these volumes. 



3(a). Load the utility $INITDSK : 

1. Press the attention key. 

2. Enter $L $INITDSK. 

3. Press the enter key. (The enter 
key must be pressed for the 
Series/ 1 to read the information 
you have typed on the screen. 
For the rest of this procedure 
and the other procedures in this 
book, the instruction to "enter" 
a command includes pressing the 
enter key.) 

3(d). Initialize the disk. : 

1. Enter ID iin, where nn is the 
hexadecimal address of the disk 
you are initiaUzing, as follows: 

. 4962 = 03 
. 4963 or 4967 = 48 
. DDSK-30 or DDSK-60 = 
44. 

Note: If you are using a 4962 
disk at address X'03' and have a 
4963 at address X'48', you must 
power off the 4963 disk. 

2. Verify that you entered the 
correct disk address and enter a 
Y in response to the verification 
prompt. 

3. Enter a Y in response to the 

DIRECTORY RECORD NUMBER 

OK? prompt. 

$INITDSK writes the volume directory 
on the disk device and then prompts 
for allocation of volumes. 



v^ 



> $L $INITDSK 
LOADING $INITDSK 
$INITDSK - DISK I 

COMMAND {?): 



98P, LP = 9100, PART=1 
NITIALIZATION UTILITY 



*^ 



COMMAND (?): ID 03 

DEVICE ALREADY INITIALIZED 
INITIALIZE DEVICE MAY DESTROY ALL DATA 
CONTINUE (Y/N)? Y 

THERE ARE 5^000 RECORDS IN YOUR DEVICE 

THE DEFAULT OF THE VOLUME DIRECTORY 
FOR THIS DEVICE IS RECORD # 129 
IT NOW EXISTS AT RECORD # 5^1 
DIRECTORY RECORD NUMBER OK (Y/N)? Y 

DISK INITIALIZED 
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Installing EDX (continued) 

3(c). Allocate volume EDX002, initialize 
the data set directory, allocate a 
data set for $edxnuc, and initialize 
IPL text. 

Respond to the prompts as shown. 



ALLOCATE A VOLUME (Y/N)? Y 
IS THE VOLUME A FIXED HEAD VOLUME (Y/N)? N 
(Only appears if you have a disk 
with fixed heads) 
VOLUME: EDX002 
SIZE IN RECORDS: 10000 
EDX002 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED (Y/N)? Y 
MAXIMUM NUMBER OF DATA SETS: 500 
DO YOU WANT TO WRITE VERIFY FOR THIS VOLUME (Y/N)? 
ALLOCATE $EDXNUC (Y/N)? Y 
VOLUME INITIALIZED 
INITIALIZE IPL TEXT (Y/N)? Y 
IPL TEXT WRITTEN 



V^ 



3(d). Allocate volume ASMLIB and 
initiaUze the data set directory. 

Respond to the prompts as shown. 



PPtX^ 



ALLOCATE ANOTHER VOLUME (Y/N)? Y 
IS THE VOLUME A FIXED HEAD VOLUME (Y/N)? N 
(Only appears if you have a disk 
with fixed heads) 
VOLUME: ASMLIB 
SIZE IN RECORDS: 10000 
ASMLIB ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED (Y/N)? Y 
MAXIMUM NUMBER OF DATA SETS: 500 
DO YOU WANT TO WRITE VERIFY FOR THIS VOLUME (Y/N)? 
ALLOCATE $EDXNUC (Y/N)? N 
VOLUME INITIALIZED 



3(e). Allocate volume EDX003 and 
initialize the data set directory. 

Respond to the prompts as shown. 



ALLOCATE ANOTHER VOLUME (Y/N)? Y 
IS THE VOLUME A FIXED HEAD VOLUME (Y/N)? 
(Only appears if you have a disk 
with fixed heads) 
VOLUME: EDX003 
SIZE IN RECORDS: 15640 
EDX003 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED 
MAXIMUM NUMBER OF DATA SETS: 500 
DO YOU WANT TO WRITE VERIFY FOR THIS 
ALLOCATE $EDXNUC (Y/N)? N 
VOLUME INITIALIZED 



(Y/N)? Y 
VOLUME (Y/N)? N 



V. 
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Installing EDX (continued) 



3(f). Does your disk have fixed heads? 

• If your disk does not have fixed 
heads, enter an N in response to 

the ALLOCATE ANOTHER 

VOLUME? prompt, end the 
$INITDSK utility as shown, and 
proceed to Step 4. 

• If your disk has fixed heads 
(4962-lF, 4962-2F, 4963-23, or 
4963-58), enter a Y in response 

to the ALLOCATE ANOTHER 

VOLUME? prompt and continue 
with step 3(g). 



ALLOCATE ANOTHER VOLUME (Y/N)? N 
COMMAND (?): EN 
$INITDSK ENDED 



\J 



3(g). Allocate volume FHVOL. Respond 
to the prompts as shown. 



IS THE VOLUME A FIXED HEAD VOLUME (Y/N)? Y 
(Only appears if you have a disk 
with fixed heads) 
VOLUME: FHVOL 
FHVOL ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED (Y/N)? Y 
MAXIMUM NUMBER OF DATA SETS: 50 

DO YOU WANT TO WRITE VERIFY FOR THIS VOLUME (Y/N)? N 
ALLOCATE $EDXNUC (Y/N)? N 
VOLUME INITIALIZED 
ALLOCATE ANOTHER VOLUME (Y/N)? N 

COMMAND (?): EN 



^ 



$INtTDSK ENDED 



\_) 



IS-24 SC34-0646 



o 



Installing EDX (continued) 

Step 4 - Copy the Starter Supervisor, Basic Utilities, and Support iVIodules 

Use the $COPYUTl utility to copy the starter system $edxnuc on XS5001 to $edxnuc on EDX002, 
along with the basic utilities and support modules. 



4(a). Load the utility $COPYUTl: 

1 . Press the attention key. 

2. Enter $L$COPYUTl. 

3. Respond to the $COPYUTi 
prompts as shown. 



> $L $C0PYUT1 

LOADING $C0PYUT1 59P , LP= 9100, PART=1 

$C0PYUT1 - DATA SET COPY UTILITY 

** WARNING "* 
MEMBERS ON TARGET VOLUME WILL BE DELETED 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE 

THE DEFINED SOURCE VOLUME IS XS5001, OK (Y/N)? Y 

THE DEFINED TARGET VOLUME IS XS5001, OK (Y/N)? N EDX002 

MEMBER WILL BE COPIED FROM XS5001 TO E0XOO2, OK (Y/N)? Y 

COMMAND (?): ROLLON 



4(b). Copy $EDXNUC to EDX002 Enter 
the copy command as shown. 



COMMAND (?): CM $EDXNUC " 

COPY COMPLETE itOO RECORDS COPIED 



J 



4(c). Copy the basic utilities and support 
modules. Respond as shown. 

$COPYUTl displays a list of the 
modules being copied from XS5001 to 
EDX002. 



COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 



After all the modules on XSSGQI are 
copied to EDX002, $C0PYUT1 displays 
the COMMAND (?): prompt. 
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Installing EDX (continued) 



4(d). End the $COPYUTl utility as sliown. 

• If you are a current user of Version 3, 4.0, 
or 4.1 and did not perform "Step 3 - 
Initialize Logical Volumes" on page IS-21, 
continue with Step 4(e) to initialize the ipl 
text using the ii command of the $initdsk 
utility. 

• If you did perform "Step 3 - Initialize 
Logical Volumes" on page IS-21, skip to 
Step 4(f). 



V. 



COMMAND (?): EN 
$C0PYUT1 ENDED 



4(e). Load the utility $INITDSK: 

1. Press the attention key. 

2. Enter $L $INITDSK. 

3. Respond to the $initdsk prompts as 
shown. 



> $L $INITDSK 

LOADING $INITDSK 98P , LP= 9200, PART= 1 

$INITDSK - DISK INITIALIZATION UTILITY 

COMMAND (?): I I 
NUCLEUS: $EDXNUC 
VOLUME: EDX002 
IPL TEXT WRITTEN 

COMMAND (?): EN 

$iNITDSK ENDED AT 01:05:16 






4(f). Remove diskette XS5001 from the diskette unit. 
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Step 5 - IPL the Starter Supervisor from Disk 



5(a). Set the IPL Source switch to ipl from the disk 
unit. 

In this example, the disk is wired as the 
Primary IPL device. Therefore, the IPL Source 
switch is set to Primary. 



Uood 


Wan 


Fl.jn 


b J 


lo J 


P 








(Odd 



Altpi.idll- 

Auto 

Normal 

Diagnoslic 







o 
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5(b). Press the LOAD button on the Series/ 1 
console. 



L )dc] 


Adil 


b J 


b J 








Mnilp 



o 
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When IPL completes, the 
system issues the 
illustrated messages 
indicating that the starter 
system is successfully 
installed. 



AAA 


EVENT DRIVEN EXECUTIVE """ V5 









N 




XPS 


AAA 










IPL 


= $EDXNUC,EDX002 












XPS 


SYSTEM STORAGE 


MAP 


USER 


USER 






USER USER 


COMMON SUPV 


SUPV 


TOTAL 


PART 


START SIZE 


SIZE START 


SIZE 


START 


SIZE 


SIZE 


# 


(DEC) (DEC) 


(HEX) (HEX) 


(HEX) 


(HEX) 


(HEX) 


(HEX) 


1 


^7616 17920 





BAOO 


BAOO 


4600 


10000 


2 


65536 











10000 


10000 


3 


65536 











10000 


10000 


h 


65536 











10000 


10000 
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BAOO 
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UNMAPPED STORAGE = 


(DEC) 2K 


BLOCKS 








EDX 


INITIALIZATION 


COMPLETE 
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Installing EDX (continued) 

Step 6 - Copy the System Support Modules and Production Utilities 

Use the $COPYUTl utility to copy the system support modules and the production utilities from 
XS5003 and XS5004. 



T\ 



6(a). Insert diskette XS5003 into the diskette unit. 
Diskette XS5003 contains two volumes: XS503A 
and XS503B. The procedure for copying 

XS503A to ASMLIB and XS503B tO EDX002 

follows in Steps 6(b) through 6(c). 

Note: If you are using a 4966 Diskette 
Magazine Unit, insert the diskette in slot 1 and 
vary the diskette online. To do this: 

1 . Press the attention key. 

2. Use the $varyon command to vary the 
diskette on line. 

3. Press the enter key. 




> $VARYON 22,1 

XS5003 ONLINE ON SLOT 1 



^ 



6(b). Load the utility $C0PYUT1 and copy 
the contents of XS503A. 

1. Press the attention key. 

2. Enter $L$COPYUTl. 

3. Respond to the $C0PYUT1 
prompts as shown. 

$COPYUTi displays a list of the 
modules being copied from XS503A 
to ASMLIB. After all the modules on 
XS503A are copied to ASMLIB 
$COPYUTl displays the 

COMMAND (?): prompt. 



r 



> $L $C0PYUT1 

LOADING $COPYUn 59P, LP= 9100. 

$C0PYUT1 - DATA SET COPY UTILITY 



PART=1 



*" WARNING "" 
MEMBERS ON TARGET VOLUME WILL BE DELETED 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGJUOUS SPACE 

THE DEFINED SOURCE VOLUME IS EDX002, OK (Y/N)? N XS503A 
THE DEFINED TARGET VOLUME IS EDX002, OK (Y/N)? N ASML I B 
MEMBER WILL BE COPIED FROM XS503A to ASMLIB OK (Y/N)? Y 

COMMAND (?): ROLLON 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 

V 
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6(c). Change the volume and copy the 
contents of XS503B. Respond to 
the $COPYUTi prompts as shown. 

$COPYUTl displays a list of the 
modules being copied from XS503B 
to EDX002. After all the modules on 
XS503B are copied to EDX002, 
$coPYUTi displays the 

COMMAND (?): prompt. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XS503A, OK (Y/N)? N XS503B 
THE DEFINED TARGET VOLUME IS ASML I B , OK (Y/N)? N EDX002 
MEMBER WILL BE COPIED FROM XS503B to EDX002 OK (Y/N)? Y 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 






6(d). Replace diskette XS5003 with 

diskette XS5004 in the diskette unit. 

Note: If you are using a 4966 
Diskette Magazine Unit, insert the 
diskette in slot 1 and vary the 
diskette online. To do this: 

1. Press the attention key. 

2. Press the enter key. 

3. Use the $varyon command to 
vary the diskette onUne. 




COMMAND (?): 
> $VARYON 22,1 
XS5004 ONLINE ON SLOT 1 



^ 



6(6). Change the volume and copy the 
contents of XS5004. Respond to 
the $COPYUTl prompts as shown. 

$COPYUTl displays a list of the 
modules being copied from XS5004 
to EDX002. After the modules from 
XS5004 are copied to EDX002, 
$COPYUTl displays the 

COMMAND (?): prompt. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XS503B, OK (Y/N)? N XS5004 
THE DEFINED TARGET VOLUME IS EDX002, OK (Y/N)? Y 
MEMBER WILL BE COPIED FROM XS5004 TO EDX002 OK (Y/N)? Y 

COMMAND (?): CALL 



COPY FROM BEGINNING (Y/N)? Y 



V. 
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6(f) Remove diskette XS5004 from the diskette 
unit. 

• If you are going to develop application 
programs on your Series/ 1 or create a 
tailored operating system, you need to 
copy the Program Preparation modules. 
Proceed to Step 7. 

• If not, you can end $copyuti as shown. 




COMMAND (?): EN 
$C0PYUT1 ENDED 



^ 



Step 7 - Copy the Program Preparation Modules and Utilities {5719-XX6) 

This step is required only if you are installing 5719-XX6. 

Now you can copy the program preparation modules and utilities. These modules are required if 
you are going to develop application programs on your Series/ 1 . 

Note: Either the Program Preparation Facilities (5719-XX6) or the Series/ 1 Macro Assembler 
(5719-ASA) is required if you are going to create a tailored operating system or prepare 
application programs. To install the Event Driven Executive Macro Assembler, follow the 
directions in the 5719-ASA Program Directory. 

To copy the program preparation modules from XX6001, XX6002, and XX6003 to ASMLIB, and the 
program preparation utilities, the session manager, and XX6004 to EDX002, perform the following 
steps: 






7(a). Insert diskette XX6001 into the 
diskette unit. 

Note: If you are using a 4966 
Diskette Magazine Unit, insert the 
diskette in slot 1 and vary the 
diskette online. To do this: 

1. Press the attention key. 

2. Press the enter key. 

3. Use the $varyon command to 
vary the diskette online. 



03070 




COMMAND (?): 

> $VARYON 22,1 

XX6001 ONLINE ON SLOT 1 
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Installing EDX (continued) 

/(b). Change volumes and copy the 

contents of XX6001. Respond to 
the $COPYUTi prompts as shown. 

$COPYUTl displays a list of the 
$EDXASM modules being copied 
from XX6001 to ASMLIB. After all 
the modules are copied from XX6001, 
$C0PYUT1 displays the 

COMMAND (?): prompt. 



V. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XSSOQit, OK (Y/N)? N XX6001 
THE DEFINED TARGET VOLUME IS EDX002, OK (Y/N)? N ASMLIB 
MEMBER WILL BE COPIED FROM XX6001 to ASMLIB OK (Y/N)? Y 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 



m^ 



7(c). Replace diskette XX6001 with 

diskette XX6002 in the diskette unit. 

Note: If you are using a 4966 
Diskette Magazine Unit, insert the 
diskette in slot 1 and vary the 
diskette online. To do this: 

1 . Press the attention key. 

2. Press the enter key. 

3. Use the $VARYON command to 
vary the diskette online. 




COMMAND (?): 
> SVARYON 22,1 
XX6002 ONLINE ON SLOT 1 



V. 



7(d). Change the volume and copy the 
contents of XX6002. Respond to 
the $COPYUTi prompts as shown. 
$COPYUTl displays a list of the 
modules being copied from XX6002 
to ASMLIB. After all the modules are 
copied from XX6002 to ASMLIB, 
$COPYUTi displays the 
COMMAND (?): prompt. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XX6001, OK (Y/N)? N XX6002 
THE DEFINED TARGET VOLUME IS ASMLIB, OK (Y/N)? Y 
MEMBER WILL BE COPIED FROM XX6002 to ASMLIB OK (Y/N)? Y 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 
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7(e). Replace diskette XX6002 with 

diskette XX6003 in the diskette unit. 

Note: If you are using a 4966 
Diskette Magazine Unit, insert the 
diskette in slot 1 and vary the 
diskette online. To do this: 

1. Press the attention key. 

2. Press the enter key. 

3. Use the $varyon command to 
vary the diskette online. 




COMMAND (?): 

> $VARYON 22,1 

XX6003 ONLINE ON SLOT 1 



V. 



7(f). Change the volume and copy the 
contents of XX6003. Respond to 
the $COPYUTl prompts as shown. 

$COPYUTl displays a list of the 
modules being copied from XX6003 
to ASMLIB. These modules are the 
copy code modules required for 
certain applications. After all the 
modules are copied from XX6003 to 
ASMLIB, $COPYUTl displays the 
COMMAND (?): prompt. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XX6002, OK (Y/N)? N XX6003 
THE DEFINED TARGET VOLUME IS ASMLIB, OK (Y/N)? Y 
MEMBER WILL BE COPIED FROM XX6003 to ASMLIB OK (Y/N)? Y 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 



y 



.^ 



7(g). Replace diskette XX6003 with 

diskette XX6004 in the diskette unit. 

Note: If you are using a 4966 
Diskette Magazine Unit, insert the 
diskette in slot 1 and vary the 
diskette online. To do this: 

1. Press the attention key. 

2. Press the enter key. 

3. Use the $varyon command to 
vary the diskette online. 




COMMAND (?): 

> SVARYON 22,1 

XX6004 ONLINE ON SLOT 1 



o 
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Installing EDX (continued) 

7(h). Change the volume and copy the 
contents of XX6004. Respond to 
the $COPYUTl prompts as shown. 

$COPYUTl displays a list of the 
modules being copied from XX6004 
to EDX002. These modules are the 
program preparation utilities and the 
session manager. After all the 
modules are copied from XX6004 to 
ASMLIB, $C0PYUT1 displays the 

COMMAND (?): prompt. 



COMMAND (?): CV 

THE DEFINED SOURCE VOLUME IS XX6003 , OK (Y/N)? N XX600i* 
THE DEFINED TARGET VOLUME IS ASMLIB, OK (Y/N)? N EDX002 
MEMBER WILL BE COPIED FROM XX6004 to EDX002 OK (Y/N)? Y 

COMMAND (?): CALL 

COPY FROM BEGINNING (Y/N)? Y 



c 



7( i ) . Remove diskette XX6004 from the 
diskette unit. 

• If you do not wish to install the 
macro library or the macro 
assembler, end the $COPYUTl 
utility as shown. 

• If you are going to install the 
Series/ 1 Macro Assembler, 
follow the directions in the 

57 19-ASA program directory. If 
you are going to install the 
Series/ 1 Macro Library, follow 
the directions in the 5719-LM9 
program directory. 




COMMAND (?): EN 



v. 



$C0PYUT1 ENDED 



Step 8 - Exercise the Utilities and Program Preparation Facilities 

This optional step exercises the utilities and program preparation facilities and verifies that you 
copied them correctly from the product diskettes. 

To perform this exercise, you need to allocate four data sets and use the verification program 

CALCDEMO. 
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The data sets you need to allocate on EDX002 are: 

• EDITWORK - a work data set used by the $FSEDIT utility 

• ASMWORK - a work data set used by the $EDXASM compiler 

• ASMOBJ - a data set where compiled output from SEDXASM is placed 

• LINKWORK - a work data set used by the SEDXLINK linkage editor. 

Except for EDITWORK, the data sets are used when you assemble and link edit CALCSRC. 
CALCSRC is the source for the calcdemo program. 

Note: By allocating these data sets at this point, you will not need to allocate them later if you 
generate a tailored operating system or prepare application programs. 



o(a). To allocate the data sets, press the attention 
key and enter $L $DISKUT1. Respond to the 
$DISKUT1 prompts as shown. 

• If you can load $diskuti and allocate the 
four data sets successfully, continue with 
Step 8(b). 

• If you cannot load $DISKUT1, you may have 
copied XS5001 to the wrong volume. 
Repeat Steps 3 through 7. 



> $L $DISKUT1 

LOADING $DISKUT1 63P, LP= 9100, PART^I 

$DISKUT1 - DATA SET MANAGEMENT UTILITY I 

USING VOLUME EDX002 

COMMAND (?): AL EDITWORK 200 D 
EDITWORK CREATED 

COMMAND (?): AL ASMWORK 500 
ASMWORK CREATED 

COMMAND {?): AL ASMOBJ 300 D 
ASMOBJ CREATED 

COMMAND {?): AL LINKWORK 600 D 
LINKWORK CREATED 

COMMAND (?): EN 

$DISKUT1 ENDED 






^ 



o 
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Installing EDX (continued) 

8(b). Press the attention key and load the 

$EDXASM compiler using the data sets as 
shown Respond to the prompts as shown to 
compile calcsrc. 

• If you load $edxasm and compile 
CALCDEMO successfully (completion code 
= -1), continue with Step 8(c). 

• If you cannot load $EDXASM, you may have 
copied XX6001 through XX6004 to the 
wrong volumes. Repeat Steps 3 through 7. 



r 



> $L $EDXASM,ASMLIB CALCSRC ASMWORK ASMOBJ 
LOADING $EDXASM 78P, LP= 9100, PART=1 

SELECT OPTIONS (?): NOL 1 ST END 

ASSEMBLY STARTED 4 OVERLAY AREAS ACTIVE 

EDX ASSEMBLER STATISTICS 

SOURCE INPUT - CALCSRC, EDX002 
WORK DATA SET - ASMWORK, EDX002 
OBJECT MODULE - ASMOBJ ,EDX002 
STATEMENTS PROCESSED - 66 



NO STATEMENTS FLAGGED 
EXTERNAL/UNDEFINED SYMBOLS 



SVC 


WXTRN 


SUPEXIT 


WXTRN 


SETBUSY 


WXTRN 


COMPLETION CODE = 


-1 


$EDXASM ENDED 








8(c). Press the attention key, load $EDXLINK using 
the data set as shown. Respond to the 
prompts as shown to link edit CALCSRC. This 
step produces a Usting on the printer 
designated as $sysprtr. 

Note: If you have created calcdemo 
previously, respond with LINK CALCDEMO REP 
END to the second STMT(?): prompt. 



r 



\^ 



> $L $EDXL1NK LINKW0RK,EDX002 

LOADING $EDXLINK 91P, LP= 9100, PART=1 

$EDXLINK - EDX LINKAGE EDITOR 

PARM(?): " 

$EDXLINK INTERACTIVE MODE 

DEFAULT VOLUME = EDX002 

STMT(?): INCLUDE ASMOBJ 

STMT(?): LINK CALCDEMO END 

$EDXLINK EXECUTION STARTED 

CALCDEMO, EDX002 STORED 

PROGRAM DATA SET SIZE = k RECORDS 

COMPLETION CODE = -1 

$EDXLINK ENDED 
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Installing EDX (continued) 



o(d). Press the attention key and enter 

$L CALCDEMO. Follow its operating 
instructions until you decide to end the 
program. When you decide to end the 
program, enter STOP. 



r 



> $L CALCDEMO 

CALCDEMO 3P, LP= 9100, PART=1 

PRESS 'ATTENTION' AND ENTER 'CALC' OR 'STOP' 

> CALC 



A = 30 
B = 6 










A + B = 

A - B = 

A * B = 

A / B = 

PRESS 'ATTENTION' 

> STOP 


36 

2k 
180 
5 REMAINDER = 
AND ENTER 'CALC' OR 


'STOP' 





CALCDEMO 


ENDED 









Now that EDX is installed, you are ready either to generate a tailored operating system or to 
prepare appUcation programs for execution on your Series/ 1 . To generate a tailored operating 
system, see Chapter 4, "Select Your Required Support" on page IS-39. For information on 
preparing programs, refer to the Event Driven Executive Language Programming Guide. 



Program Function Keys for the 4979 Display Station 

If you use the starter system as your operating system and have a 4979 Display Station at 
address 04, the program function keys operate as follows: 



Key label 


Function 


PF1 


PF1 


PF2 


PF3 


PF3 


PF5 


PF4 


PF2 


PF5 


PF4 


PF6 


PF6 



(^'^, 
v.^' 



Terminal Initialization for the Starter System 



All terminals are initialized as part of the IPL process. In the starter system, the primary logging 
terminal to receive/display all exception messages ($SYSLOG) is defined as a 4978 Display 
Station at hardware address X'04'. If there is no terminal at hardware address X*04', terminal 
initialization support relocates $SYSLOG to a 4978 Display Station at hardware address X'24'. If 
there is no terminal at hardware address X'24', terminal initialization support relocates $SYSLOG 
to a 4980 Display Station at hardware address X'80'. 



^ 
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Installing EDX (continued) 



If an error occurs when writing to $SYSL0G, terminal initialization reverts to the alternate logging 
device ($sysloga). In the starter system, $sysloga is defined as a teletypewriter at hardware 
address X'OO'. 

Note: If a TTY attachment exists at address without a terminal attached to it, the system 
cannot detect an error when writing to $SYSL0GA, terminal initialization does not revert to 
$SYSLOGB, and messages are not displayed on any terminals. 

If an error occurs when writing to $SYSLOGA, terminal initialization reverts to the second 
alternate logging device ($syslogb). In the starter system, $SYSLOGB is defined as a 3101 
Display Terminal in block mode at hardware address X'59', connected via a Multifunction 
Attachment (mfa) at hardware address X'58'. If no MFA exists at hardware address X'58', 
terminal initialization support relocates $syslogb to a 3101 Display Terminal in block mode, 
connected to a single line acca (#1610) attachment at hardware address X'08'. If no ACCA 
attachment exists at hardware address X'08', terminal initialization support relocates $SYSLOGB 
to a 3101 Display Terminal in block mode, connected to a Multiline Terminal Adapter 
(2091/2092) at hardware address X'60'. If no mlta attachment exists at hardware address 
X'60', terminal initialization support relocates $syslogb to a 3101 Display Terminal in block 
mode connected to a Feature Programmable Communications Adapter (2095/2096) at 
hardware address X'68'. 
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Chapter 4. Select Your Required Support 



System Features 



This chapter helps you select the system features you need for your tailored operating system. 
System features include defining processor storage characteristics, the I/O devices attached to 
your Series/ 1 , the software features you require for your application, and the EDX-related 
products you are including as part of your tailored operating system. 



The Remote Support Link 



The Remote Support Link allows an IBM support center representative to dial into your Series/ 1 . 
Using a switched telephone network, he can issue operator commands, execute edx programs, 
and transfer disk data sets and messages. The required terminal definition statements for this 
link are discussed in "Step 2 - Defining Your System Configuration" on page IS-42; the 
supervisor modules you must include are discussed in "Translation Table Support" on page 
IS-56 and "Terminal Support" on page IS-57. A detailed description of the Remote Support 
Link is presented in the Problem Determination Guide and the IBM Series/ 1 Software Service 
Guide, GC34-0099. 



Designing Your Operating System 



The steps you perform in designing your operating system are: 
Step 1 Estimate your supervisor's storage requirements. 
Step 2 Define your system configuration. 
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Designing Your Operating System (continued) 

Step 3 Select your software support. 

Step 4 Define the structure of your supervisor, if applicable. 

Note: Be sure to review the program directories for all EDX-related products you are instaUing 
to determine any special considerations before generating a tailored operating system. 

To help you design your operating system, the following work sheets are provided in 
Appendix E: 

• Use work sheet 1 to estimate the size of your supervisor. 

• Use work sheet 2 to define the characteristics and partition structure of processor storage 
and the I/O devices attached to your Series/ 1. Use work sheet 2 with $edxdef to tailor 
your operating system. 

• Use work sheet 3 to define the software features you require to support the defined I/O 
devices and the EDX-related products you include in your system. Use work sheet 3 to select 
the supervisor modules to be included in $LNKCNTL. 

• Use work sheet 4 to estimate the amount of storage required by supervisor object modules 
that are located outside of partition 1 and the amount of storage required by programs to 
execute within a partition. 

If you decide to locate your supervisor totally in partition 1, skip step 5. Complete work sheets 
2 and 3 and follow the procedures in Chapter 5, "Generate a Tailored Operating System" on 
page IS-77. 

However, before you can select your required support, you should be famiUar with the 
characteristics of processor storage. 






Processor Storage 



Processor storage is divided into partitions. A partition is a contiguous, fixed-length area of 
storage (maximum of 64K or 65,536 bytes) that is used for execution of programs. You can 
define up to eight partitions for the 4955, or 4956, up to four partitions for the 4954, and up to 
two partitions for the 4952. 

Note: You can define up to 16 partitions for Extended Address Mode. Refer to the Extended 
Address Mode and Performance Analyzer User Guide for detailed information. 

The supervisor (or a portion of the supervisor) is always located in partition 1 . The storage 
available in all defined partitions for program execution is limited to 64K bytes minus the 
number of bytes occupied by the supervisor. Each partition is defined in multiples of 2K bytes 
and can contain more than one program simultaneously within the limits of the storage assigned 
to it. 
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Designing Your Operating System (continued) 

Sample System 

This chapter contains an example of designing a tailored operating system to match specific 
hardware requirements and software features. When applicable, excerpts from work sheet 2 are 
shown as examples of how to code a definition statement for a specific I/O device. At the end 
of the chapter, marked up copies of work sheets 2 and 3 show the definition statements and the 
software features that define the sample system. 

The sample assumes that the hardware and software requirements are as follows: 

Hardware Requirements: Our sample Series/ 1 is a 4956 processor with 512K bytes of 
storage. The devices supported and their address assignments are: 

Device Address 

4962- IF Disk Storage Unit 03 

4964 Diskette Unit 02 

4978 Display Station 24 

4979 Display Station 04 

4973 Line Printer 21 

The 4979 Display Station is defined as the primary system logging device ($syslog) to receive 
all exception messages. The 4978 Display Station is defined as the alternate system logging 
device ($sysloga). 

The 4973 Printer is defined as the system printer ($SYSPRTR) to receive the hard-copy output 
from all system programs. 

Software Support Requirements: The following software features are required for the 
sample system: 

Software Features Requirements 

Multipartition supervisor Supervisor code in partitions 1 and 8 

Common area Partitions 2, 4, and 5 

Number of partitions and sizes 5 (0,24,16,20,32) 

Number of programs per partition (1,10,10,5,5) 

Unmapped storage YES 

Each disk device will have its own task for input/output. 
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Step 1 - Estimating Total Supervisor Size 



Your first step is to estimate the total size of your supervisor. Use work sheet 1 which contains 
a list of the I/O devices you can attach to the Series/ 1 . Along with each device type is the 
amount of storage the supervisor requires to support that device. An estimate of 64K (65536 
bytes) or greater indicates that you should reduce the size of your supervisor. The ways to 
reduce the size of your supervisor are discussed under "Step 4 - Defining Supervisor Structure" 
on page IS-68. However, before performing that step, you should perform steps 2 and 3 first in 
order to be aware of the I/O devices and software support you are including in your operating 
system. 



Step 2 - Defining Your System Configuration 



The second step in selecting your required support is to describe the devices attached to your 
Series/ 1. To do this, you must know the configuration of the system on which you intend to run 
the tailored operating system. When coding the system definition statements (work sheet 2), 
one of the operands you must specify is the device hardware address. Use the $iOTEST utility 
(ld command) to find out which devices are installed on your system and their addresses. 
Before SIOTEST can list all the devices attached to your Series/ 1, the devices must be switched 
on. The following example shows the devices and their address assignments for the sample 
system. 



> $L $IOTEST 
LOADING $IOTEST 



47P, LP= 8F00, PART=1 



ATTLIST (ALTER) TO STOP LOOPING FUNCTIONS 
COMMAND (?): LD 



ACTUAL SERIES/1 HARDWARE CONFIGURATION 



DEVICE TYPE 



ADDRESS 


ID 


00 


0010 


03 


OOCA 


Ok 


0406 


09 


1006 


12 


0106 


19 


1006 


21 


0306 


2k 


040E 


ko 


0028 


k] 


0028 


kk 


5212 


48 


3106 


COMMAND 


{?): 



TELETYPEWRITER ADAPTER (TTY) 

4962 DISK MDL 3 OR 4 
4979 DISPLAY STATION 
SINGLE LINE B I SYNC 

4964 DISKETTE UNIT 
SINGLE LINE BISYNC 
4973 PRINTER 

4978 DISPLAY STATION 
TIMER FEATURE 
TIMER FEATURE 

4965 DISK SUBSYSTEM 

4963 DISK SUBSYSTEM 
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Step 2 - Defining Your System Configuration (continued) 



Figure 5 shows an example of using the $iotest ls command to list the hardware devices 
supported by the IBM-supplied supervisor under which $iOTEST is running. Figure 5 shows the 
devices supported by the starter system $edxnuc. 

By comparing the previous figure and Figure 5 , you can see that the starter system does not 
support some of the devices in our sample system. If your actual Series/ 1 configuration is 
different than the hardware devices supported by the starter system and you want to support 
these additional devices, you need to define the configuration of your system. Use work sheet 2 
to specify the configuration statements for your system. 






/" 



COMMAND (?): LS 

HARDWARE DEVICES SUPPORTED BY THIS SUPERVISOR 

DEVICE TYPE 



TELETYPEWRITER ADAPTER (TTY) 
A97A PRINTER 

4964 DISKETTE UNIT 
4978 DISPLAY STATION 

4966 DISKETTE MAGAZINE UNIT 

4965 DISKETTE UNIT 
4965 DISKETTE UNIT 

4967 DISK SUBSYSTEM 
UNIDENTIFIED UNIT 

MFA (1310) SINGLE LINE ACCA 
MFA WITH 4975-0 1L PRINTER 
MFA WITH 4975-02L PRINTER 



ADDRESS 


ID 


00 


0010 


01 


0206 


02 


0106 


04 


040E 


22 


0126 


44 


5212 


45 


5212 


48 


3116 


58 


70EE 


59 


2816 


5A 


0208 


5B 


020A 


COMMAND 


(?): 



MODE = 3IOIB 



Figure 5. Hardware Devices Supported by the Starter System ($EDXNUC) 



System Definition Statements 



The following definition statements are used to describe processor storage and I/O devices to 
your operating system: 



ADAPTER - Defines a multiline attachment 
BSCLINE - Defines a binary synchronous Une 
DISK - Defines direct access storage devices 
EXIODEV - Defines EXIO interface devices 
HOSTCOMM - Defines host communication support 
SENSORIO - Defines sensor I/O devices 
SYSTEM - Defines processor characteristics 
TAPE - Defines tape devices 
TERMINAL - Defines terminals 
TIMER - Defines system timer feature. 
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Step 2 - Defining Your System Configuration (continued) 

A brief description of eacli of these definition statements is presented in this chapter. A detailed 
description of the statements, along with the syntax and operand definitions, is provided in 
Appendix A. 

The definition statements presented here are in the order of appearance in work sheet 2. 

SYSTEM Statement 

The SYSTEM statement defines the partition structure, the storage assigned to each partition for 
execution of application programs, and the number of programs that can execute concurrently in 
each partition. This statement must be specified only once. 

The MAXPROG= operand specifies the maximum number of concurrently executing programs to 
be allowed in each partition. 

The PARTS= operand specifies the number of 2K (2K=2048 bytes) blocks of storage assigned to 
each partition. The PARTS= operand also defines the partition structure of your system. The 
supervisor (or a portion of the supervisor) always resides in partition 1 . Partition 1 must be 
large enough to contain the supervisor. If you have only one partition, this partition must be 
large enough to contain the entire supervisor and your largest appUcation program. If you have 
multiple partitions, they must be defined in multiples of 2K bytes of storage and can contain 
more than one program simultaneously within the limits of the storage assigned to each 
partition. 

See "SYSTEM - Define Processor Storage" on page IS- 162 for a detailed description of this ^<r^ 

statement. \^ 

If you determined in "Step 1 - Estimating Total Supervisor Size" on page IS-42 that your 
supervisor is 64K or greater or that you want to free up storage in partition 1, you may need to 
modify the PARTS= and maxprog= operands of the system statement. After you perform 
"Step 4 - Defining Supervisor Structure" on page IS-68, then you can decide how to structure 
your processor storage (number of partitions and their sizes) and the number of programs that 
can execute in each partition. 

The sample system is defined as having five partitions (0, 24, 16, 20, 32). For each partition, 
the maximum number of programs that can execute concurrently are 1, 10, 10, 5, 5, 
respectively. The system statement defined for the sample system is: 



SYSTEM MAXPR0G=(1 ,10,10,5,5) , PARTS= (0 , 24 , 16,20,32) , 
COMMON= (0,2,0,1,1) 



1^ 



.^ 
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Step 2 - Defining Your System Configuration (continued) 

The sample system logically and physically maps in storage as follows: 
Logical mapping: 



\ 



Address 
space 

Address 
space 1 

Address 
space 2 

Address 
space 3 

Address 
space 4 

Address 
space 5 

Address 
space 6 

Address 
space 7 



22KB supervisor 


14KB user space 
(partition 1) 


Invalid 


4KB common 


48KB user space 
(partition 2) 


Invalid 


32KB user space (partition 3) 


Invalid 


2KB common 


40KB user space 
(partition 4) 


Invalid 


2KB common 


62KB user space (partition 5) 


Invalid (partition 6) 


Invalid (partition 7) 


11KB supervisor 


1 KB user space 
(partition 8) 


Invalid 


274KB unmapped storage 



Physical mapping: 



36KB (part#1) 


48KB ( 


part #2) 


32KB (part #3) | 


40KB (part #4) 


62KB (part #5) 


12KB (part #8) 


274KB unmapped 
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Step 2 - Defining Your System Configuration (continued) 

1. Partition 1 is defined to contain supervisor code only (part=o). The supervisor required 11 
blocks (22KB) of storage and the initialization routines required 7 blocks (14KB) of storage 
at IPL time. After initialization, the 7 blocks of storage required by the initialization routines 
were given back as user space. 

2. Partition 2 required 2 blocks (4KB) to serve as addressing pointers to the COMMON area and 
has 24 blocks (48KB) of actual storage mapped for user space. The 2 blocks of pointers 
cannot map actual storage since they are reserved as common area pointers. Partition 2 can 
execute up to 10 programs concurrently. 

3. Partition 3 requires 16 blocks (32KB) of storage for user space and can execute up to 10 
programs concurrently. 

4. Partition 4 requires 2 blocks (4KB) to serve as addressing pointers to the COMMON area and 
has 20 blocks (40KB) of actual storage mapped for user space. The 2 blocks of pointers 
cannot map actual storage since they are reserved as COMMON area pointers. Partition 4 can 
execute up to 5 programs concurrently. 

5. Partition 5 requires 2 blocks (4KB) to serve as addressing pointers to the common area and 
has 3 1 blocks (62KB) of actual storage mapped for user space. The 2 blocks of pointers 
cannot map actual storage since they are reserved as common area pointers. Partition 5 can 
execute up to 5 programs concurrently. 

6. Partition 6 is not defined. 

7. Partition 7 is not defined. 

8. Partition 8 is not defined on the SYSTEM statement. However, a multipartition supervisor 
was defined with the part statement in the $LNKCNTL data set as having supervisor code in 
partition 8. As a result, partition 8 was defined automatically and 1 1KB of storage was 
assigned to the supervisor. In addition, because storage is assigned in 2K blocks, 1KB of 
storage was assigned as user space for a total of 12KB in partition 8. 

9. The size of processor storage is 512KB. Only 238KB of storage was defined leaving 274KB 
of unmapped storage. 



TAPE Statement 



The TAPE statement defines the 4968 and 4969 tape units. One tape statement is required for 
each tape device attached to your Series/ 1. Group all tape and disk statements together. The 
last TAPE or disk statement must specify end=yes (as shown in work sheet 2). 

See "TAPE - Define Tape Device" on page IS-181 for a detailed description of this statement. 
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Step 2 - Defining Your System Configuration (continued) 



DISK Statement 



The DISK statement defines disk and diskette devices to the system. One disk statement is 
required for each disk or diskette device attached to your Series/ 1 . 

The sample system is defined as having a 4962- IF disk and a 4964 diskette unit. These devices 
are defined on work sheet 2 as follows: 



DISK DEVICE=4962-1F,ADDRESS=03,TASK=YES 
DISK DEVICE=4964 , ADDRESS=02 , TASK=YES , END=YES 






See "DISK - Define Direct Access Storage" on page IS-154 for a detailed description of this 
statement. 

Disk Considerations: You should specify all disks before you specify diskettes in order to 
get better performance. You can designate a disk volume as a performance volume by specifying 
the VOLNAME operand in the DISK definition statement. As with all volumes, you must allocate 
and initialize this volume using the $INITDSK utility. However, a performance volume is opened 
at IPL time making the opening of data sets in a performance volume faster. 

Each performance volume requires 46 bytes in the supervisor; this additional storage cannot be 
reclaimed until you generate a new supervisor. 

Note: Deleting a performance volume does not allow the storage to be reused. 
TIMER Statement 

The TIMER statement defines the #7840 Timer Feature as the system timer in the generated 
system. This statement is used only for defining the #7840 timer. If the system has a native 
timer (4952, 4954 and 4956 processors) that is used instead of the #7840 timer feature card, 
you do not need to code this statement. 

See "TIMER - Define System Timer Features" on page IS-242 for a detailed description of this 
statement. 

ADAPTER Statement 

The ADAPTER statement defines one of the following multiline attachment features: 

• Multifunction Attachment Feature #1310 

• Printer Attachment - 5200 Series Feature #5640 

• Multidrop Work Station Attachment Feature #1250. 
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Step 2 - Defining Your System Configuration (continued) 

One ADAPTER statement is required for each adapter attachment attached to your Series/ 1 . All 
ADAPTER statements must be grouped together and must precede the definition of the first 
device attached to a specific attachment. The last adapter statement specified must include 

END=YES. 

See "ADAPTER - Define a Multiline Attachment" on page IS-146 for a detailed description of 
this statement. 

TERMINAL Statement 

The TERMINAL statement defines each EDX terminal to be supported by the operating system. 
The DEVICE operand of the terminal statement identifies the type of terminal. EDX supports 
many different terminals; see "TERMINAL - Define Input/Output Terminals" on page IS- 183 
for a list of the supported terminals. The required operands and defaults of the terminal 
statement can be different for each device; therefore, the terminal statement is presented by 
device type. (See "TERMINAL - Define Input/Output Terminals" on page IS- 183 for a 
detailed description of this statement.) 

Notes: 

1. The 3101 Display Terminal is connected to the Series/ 1 by several EDX support attachment 
features. For each attachment and type of interface, it is necessary to set the 3101 switches, 
have the attachment card physically jumpered, connect the cables, and specify the 
appropriate terminal statement. Before specifying a terminal statement for the 3101, 

see Appendix C, "3101 Configuration Information" on page IS-249. i^ 

\. 

2. See "ACCA-Type Terminals" on page IS-214 for information about the TERMINAL 
statement for the Remote Support Link. 

Our sample system is defined as having the following terminals: 

• a 4973 printer 

• a 4979 display station 

• a 4978 display station. 

The terminal statements that define these I/O devices to our operating system are: 



$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=2 1 

$SYSLOG TERMINAL DEVICE=4979 , ADDRESS=04 ,HDCOPY=$SYSPRTR 

$SYSLOGA terminal DEVICE=4978 , ADDRESS=24 , HDC0PY=$SYSPRTR,END=YES 



J 
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Step 2 - Defining Your System Configuration (continued) 



BSCLINE Statement 



The BSCLINE statement defines a binary synchronous line. One bscline is required for each Une 
to be referenced by programs using the Binary Synchronous Communications Access Method 
(bscam). 

See "BSCLINE - Define a Binary Synchronous Line" on page IS- 150 for a detailed description 
of this statement. 



EXIODEV Statement 



The EXIODEV statement defines the devices to be supported through the EXIO interface. All 
EXIODEV statements must be grouped together. The last EXiODEV statement must include an 
END = YES specification. 

An EXIODEV statement must be defined for each System/370 Channel Device attached to your 
system. For more information on defining channel attach devices, refer to the Program 
Directory for the Series/ 1 -System/ 3 70 Channel Attach (5719-CXl). 

An EXIODEV statement must be defined for each physical unit that defines the SDLC line. For 
more information on defining an SDLC line, refer to the Program Directory for the Series/ 1 
Systems Network Architecture, (5719-SXl). 

See "EXIODEV - Define EXIO Interface Device" on page IS- 157 for a detailed description of 
this statement. 



HOSTCOMM Statement 



The HOSTCOMM statement defines the device type and address of the device to be used for host 
communication support. This support only operates with the Host Communications Facility 
Installed User Program (lUP). 

The Host Communications FaciUty (hcf) allows an EDL program to communicate with the Host 
Communication Facility lUP installed on a host IBM S/370. The HCF is used to perform file 
transfers to and from the host and to submit a job stream to the host. You must use a 
point-to-point nonswitched BSC line to connect the Series/ 1 and S/370. 

See "HOSTCOMM - Define Host Communications Support" on page IS-159 for a detailed 
description of this statement. 



SENSORIO Statement 



The SENSORIO statement defines the sensor I/O devices to be supported. All SENSORIO 
statements must be grouped together and the last one must include an end=yes specification. 

See "SENSORIO - Define Sensor I/O Devices" on page IS- 160 for a detailed description of this 
statement. 
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Step 2 - Defining Your System Configuration (continued) 

System Common Data Area 

The system common data area is known by the system global name $SYSCOM. $SYSCOM is a data 
area in an operating system which can be accessed from applications written in EDL, assembler 
language, COBOL, FORTRAN, Pascal, and PL/i. It is used for communication and synchronization 
between programs. If you select this option, you can map the portion of the supervisor 
containing $SYSCOM in partition 1 to the partitions of your choice. See "SYSTEM - Define 
Processor Storage" on page IS- 162 for a description of coding the system common data area. 

FORTRAN and assembler language programs can reference the system common data area directly 
by referencing global section definitions. PL/i and EDL programs must reference the common 
area indirectly by using the contents of $SYSCOM as a base address and referencing data 
elements as displacements from this base. Refer to the appropriate language user's guide for 
examples of using $SYSCOM and global sections. 

As shown in work sheet 2, there is an example of specifying a 128-word area called $EDXPTCH 
which can be used as part of $syscom and should be coded as part of your definition 
statements. In addition, $SYSCOM consists of two queue control blocks (QCBs) and two event 
control blocks (ECBs). These control blocks can be used as is or you can change them. 



Step 3 - Selecting Your Software Support 

The third step in selecting your required support is to choose the software features needed to \_ J^' 

support your configuration and the EDX-related products you are installing as part of your 
system. Use work sheet 3 to keep track of the support object modules you need. 

If you determined in Step 1 that your supervisor is 64K or greater or that you want to free up 
storage in partition 1 , you need to know which support object modules need to be included in 
your supervisor. You need this information to complete "Step 4 - Defining Supervisor 
Structure" on page IS-68. 

The object modules that provide the software features supported by EDX are explained on the 
following pages. For the starter system, these names are contained in the $LNKCNTL data set on 
volume ASMLIB. Work sheet 3 parallels $lnkcntl which contains the control statements and 
object module names used by the linkage editor $xpslink. $xpslink is a linkage editor that is 
set up to generate a single or multipartition supervisor and is used only during system 
generation. 
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Step 3 - Selecting Your Software Support (continued) 






Control statements are the instructions used by $XPSLINK to convert the assembled object 
modules into an executable load module. Work sheet 3 contains the following control 
statements in the order shown below. 

OPTION NOVERLAY An OPTION noverlay statement specifies that the supervisor will not 

default to overlay structure. 

PART A PART statement defines the partition number where groupings of 

supervisor object modules are to be located. 

VOLUME A VOLUME statement defines the default volume for $xpslink control 

statements. 

OVLAREA An OVLAREA statement defines an overlay area. The supervisor 

defaults to overlay structure. 

INCLUDE An INCLUDE statement identifies an object module to be included in 

the generated supervisor. 

LINK A LINK statement causes $xpslink to perform a link using the control 

statements within the data set and to store the resulting executable 
load module (the supervisor) in a data set named $EDXNUCx where x 
is any alphanumeric character. 

With the exception of the OPTION NOVERLAY and the part statements, these control statements 
are explained under the $EDXLINK utility in the Operator Commands and Utilities Reference. 



OPTION NOVERLAY Statement 



The OPTION NOVERLAY Statement is an $xpslink statement and is used only during system 
generation. If this statement is included in the $lnkcntl data set, the supervisor is built without 
the overlay structure. Without overlay structure, $XPSLINK automatically includes required 
initiaUzation routines in your supervisor as resident programs. This means that the required 
initiahzation routines are loaded simultaneously in supervisor storage at IPL time. As a result, 
they increase the amount of storage required by the supervisor in partition 1 . For further 
information, see "Including Initialization Routines in Your Supervisor" on page IS-65. 



PART Statement 



The PART statement is an SXPSLINK statement and is used only during system generation. A 
PART statement defines the partition number where supervisor object modules are to be located 
and is used to create a multipartition supervisor. One PART statement is required for each 
partition in which you have supervisor object modules. 
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Step 3 - Selecting Your Software Support (continued) 

The number on the part statement preceding a group of modules specifies the partition where 
the modules are to be located. Some groups of supervisor object modules must remain located 
in partition 1; others can be located outside of partition 1. In work sheet 3, the modules are 
grouped and a statement preceding each group indicates if that group of modules can be located 
outside of partition 1 . To locate a group of modules outside partition 1 , you must move the 
modules to the area specified on the work sheet and in the $lnkcntl data set. Then enter the 
number of the partition where you want the group located on the part statement. 

All groups of object modules defined to be in a specific partition must be adjacent to one 
another. For example, you can specify partitions 1, 1, 2, 2, 3, 4, 4 or 1, 2, 2, 4, 4, 3, 5, 5, 6, 
6, 7. You cannot specify partitions 1,3, 2, 1,3, 4, 3. This means that if you have already 
defined a group of modules to be in a specific partition and you wish to place another group of 
modules in that same partition, you must move the second group of modules to follow the part 
statement defining that partition. Also, if you define PART statements, you must specify PART 1 
first. 

Syntax: 



-\, 



PART partnumber 

Required: partnumber 
Default: none 



Example: Define specific groups of object modules in partitions 3 and 4. 



SUPERVISOR CODE BEING MOVED OUT OF 
PARTITION 1 'MUST' BE MOVED TO HERE 



SENSOR INPUT/OUTPUT - MUST BE GROUPED TOGETHER IN ANY PARTITION 



BASIC SENSOR I/O SUPPORT 
ANALOG INPUT SUPPORT 
ANALOG OUTPUT SUPPORT 
DIGITAL INPUT/OUTPUT SUPPORT 
PROCESS INTERRUPT SUPPORT 

" B I SYNC COMMUNICATION MAY BE IN ANY PARTITION 

PART k 

INCLUDE BSCAM "7* B I SYNC COMMUNICATION SUPPORT 






PART 3 






INCLUDE 


SBCOM 


"15 


INCLUDE 


SBAI 


*3^ 


INCLUDE 


SBAO 


AnA 


INCLUDE 


SBIDO 


.3. 


INCLUDE 


SBPI 


^3* 
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Step 3 - Selecting Your Software Support (continued) 

VOLUME Statement 

The VOLUME statement defines the default volume for $xpslink control statements. 

XS5002 XS5002 is the default volume for the object modules. This statement is required 

and must be included in every supervisor. 



OVLAREA Statement 



The OVLAREA statement is an optional Unk-control statement used to define an overlay area 
within the supervisor. This area is used to process initialization routines automatically included 
by $XPSLINK as overlay segments. 

Before including this statement in your link-control data set, see "Define an Overlay Area" on 
page IS-63. 



INCLUDE Statement 

The INCLUDE statement identifies each supervisor object module to be included in your 
generated supervisor. 

An explanation of each supervisor object module and the criteria for including a module in your 
supervisor follows. The modules are shown in the same order as they appear in work sheet 3. 

Supervisor Support 

These supervisor object modules must reside in partition 1 . 

EDXSYS EDXSYS is a required module and must be included in every supervisor. EDXSYS 

contains the following five tables: 

Reserved storage locations 
Device vector table 
Communications vector table 
Task supervisor work area 
Emulator command table. 

ASMOBJ ASMOBJ is a required module and must be included in every supervisor. This 

module will contain the object code resulting from assembling the $EDXDEF data 
set which contains the system definition statements. You have the option of 
changing the name of this module or use it as it exists. 

EDXSVCX EDXSVCX is a required module and must be included in every supervisor. It 
performs task requests. 
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Step 3 - Selecting Your Software Support (continued) 

$DBUGNUC $DBUGNUC must be included if you wish to debug programs using tlie $debug 
utility. 

EDXALU EDXALU is a required module and must be included in every supervisor. 

EDXSTART edxstart is a required module and must be included in every supervisor. 
EDXSTART includes the system initialization task. It is attached at IPL and 
initializes the supervisor by calling in edxinit which processes the initialization 
routines. EDXSTART is used also for default exception processing for program, 
machine, and soft exception checks. 

SWAITM SWAITM is an optional module and is required if you use the wait on multiple 
events option. 

If you include swaitm, be sure to code the mecblist operand on the system 
statement. 



Timer Support 



These supervisor object modules must be located in in partition 1 . 

EDXTIMER edxtimer must be included if your Series/ 1 has a 4955 processor and you 
defined the #7840 timer feature with the TIMER definition statement. If you 
include edxtimer, $xpslink automatically includes the initiaUzation module 

TIMRINIT. 

EDXTIMR2 EDXTIMR2 must be included if your Series/ 1 is a 4952, 4954, or 4956 processor 
with native timer support. If you include EDXTIMR2, $XPSLINK automatically 
includes the initialization module CLOKINIT. 

EXIO Control Support 

This supervisor object module mmt be located in in partition 1 . 

lOSEXIO lOSEXlO is optional and is required only if you intend to attach and control OEM 

devices or to support standard devices in a nonstandard manner. The device is 
defined with the EXIODEV definition statement. If you include lOSEXiO, $xpslink 
automatically includes the initialization module EXIOINIT. 

EXIOTRC EXIOTRC is optional and is required only if you want to trace I/O operations and 
interrupts for an EXIO device with the $traceio utility. In addition, EXIOTRC 
enables you to record conditions codes, completion codes, ISB and dcb 
information, and status words for a device interrupt from a 
start-cycle-steal-status (scss) operation. If you do not include EXiOTRC and 
include lOSEXiO, $xpslink automatically includes NOEXIOTR. 
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Step 3 - Selecting Your Software Support (continued) 

Error Logging Support 

These supervisor object modules must be located in partition 1 . 

SYSLOG SYSLOG is used by the $LOG utility to log errors to a disk or diskette data set. 

$XPSLINK automatically includes SYSLOG. 

CIRCBUFF CIRCBUFF is required if the storage program check/machine check log is to be 
kept. CIRCBUFF implements the optional software trace table. This table 
contains program check, soft exception, and machine check trace data. It also 
offers information on the types of errors that have been occurring. (Refer to the 
Problem Determination Guide for more information.) 

Optional Function Support 

These supervisor object modules must be located in in partition 1 . 

RLOADER RLOADER is required if you intend to load programs from secondary storage (disk 
or diskette) with either the $L operator command or the load instruction. If you 
include rloader, $xpslink automatically includes loadinit. If you do not 
include RLOADER, you must link edit your application programs with the 
supervisor for them to execute (see $PROGi under "System Initialization 
Support" on page IS-60 for additional information). 

STORMGR STORMGR is required to gain access to unmapped storage from an application 
program or to use the $MEMDSK utility to set up a memory disk volume. The 
$MEMDSK utility allows you to use part or all of unmapped storage as if it were a 
single-volume disk. See the Operator Commands and Utilities Reference for 
information on the $MEMDSK utiUty. If you include STORMGR, $xpslink 
automatically includes STORINIT. If you do not include STORMGR, $XPSLINK 
automatically includes NOSTGMGR. STORMGR contains support for the Event 
Driven Language instructions GETSTG, freestg, and swap, and the storblk 
statement, storblk creates an unmapped storage control block, and GETSTG, 
freestg, and swap enable application programs to use unmapped areas in the 
system. 

lAMQCB lAMQCB is required if the Indexed Access Method Version 2 (5719-AM4) is 

installed or will be installed in the future. 

PWRAM80 PWRAM80 is an optional module that can be included for the 4980 display station. 
PWRAM80 automatically loads the control store, image store, and microcode 
necessary for 4980 display station operation. If you do not include PWRAM80 
and you turn off a 4980 display station, you must ipl your system to make the 
4980 operational again. 
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Step 3 - Selecting Your Software Support (continued) 

Host Communication Facility (HCF) 

This supervisor object module must be located in partition 1 . 

TPCOM TPCOM is required if you defined host communication support (communication to 

a S/370) with the hostcomm definition statement. If you include tpcom, 
$XPSLINK automatically includes the initialization module TPINIT. 

Translation Table Support 

These supervisor object modules must be located in partition 1 . 

TRASCII TRASCII is required if feature numbers #1310, #2095/2096, and #7850 are used 

to connect ACCA or TTY I/O devices to your Series/ 1. 

Note: You must include this module or trebasc as well as both lOSTERM and 
lOSACCA for the Remote Support Link. Refer to Problem Determination Guide 
for more information about the Remote Support Link. 



TREBASC 



TREBCD 
or 
TRCRSP 



Disk(ette) and Tape Support 



TREBASC is required if feature numbers #1610 and #2091/2092 are used to 
connect ACCA or TTY I/O devices to your Series/ 1. 

Note; You must include this or TRASCII as well as both lOSTERM and lOSACCA 
for the Remote Support Link. Refer to Problem Determination Guide for more 
information about the Remote Support Link. 

Include either of these modules if you defined a 2741 terminal 
(DEVlCE=274l) to the supervisor. A 2741 terminal can use either 
TREBCD or TRCRSP. Include TREBCD for processor-to-processor support 
(device=proc). 



These supervisor object modules can be placed in any partition. However, any modules that 
you include must remain as a group. 

DISKIO DISKIO must be included if you defined a disk or diskette device using the DISK 

definition statement. If you include DISKIO, DISKINIT and DSKINIT2 are included 
automatically. 

D49624 D49624 is optional and is required only if you defined a 4962 disk and/or 4964 

diskette with the disk definition statement. 

D4963A D4963A is optional and is required only if you defined a 4963, 4967, DDSK-30, 

or DDSK-60 disk with the disk definition statement. 

D4966A D4966A is optional and is required only if you defined a 4965 and/or 4966 

diskette unit with the DISK definition statement. 






\> 
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Step 3 - Selecting Your Software Support (continued) 



D1024 D1024 must be included if you intend to use double density diskettes at 1024 

bytes per sector on a 4965 or 4966 diskette unit. 

Once included, a copy of $101024 is loaded automatically for each disk task 
defined for a 4965 and/or 4966 diskette unit. $101024 is loaded into the highest 
available partition the first time 1024 bytes per sector support is required for a 
particular device. $101024 remains in storage until that diskette unit is varied 
offUne or is varied onUne again with a non-1024-bytes-per-sector diskette. 

D4969A D4969A is required if you defined one or more 4968 or 4969 tape units with the 

TAPE definition statement. If you include D4969A, $EDXLINK automatically 
includes the initialization module tapeinit. 



Terminal Support 



These supervisor object modules can be placed in any partition. However, any modules that you 
include must remain as a group. 



EDXTIO EDXTIO must be included if you defined terminals with the TERMINAL definition 

statement. Terminals include the 4973, 4974, 4975, 4975-OlA 4978, 4979, 
4980, 5219, 5224, 5225, GPIB, Series/ 1 -Series/ 1, Virtual terminals, ACCA.TTY, 
2741, and 4013. If you include EDXTIO, $XPSLINK automatically includes the 
initialization modules TERMINIT and EDXTERMQ. If you do not include EDXTIO, 
$XPSLINK automatically includes NOTIO. 

MINMSG MINMSG must be included if you wish to have only that part of the messages that 
are resident in storage appear. This means that only the message text is issued; 
parameters are not issued. If system commands and/or utilities are used, the 
messages will not contain the parameters and may not be meaningful. For both 
systems with secondary storage (disk or diskette) and without secondary storage, 
MINMSG is the only module required for storage-resident messages support. If 
you include MINMSG, do not include FULLMSG. 

FULLMSG FULLMSG must be included if you wish to have full message data set support. 
This means that messages (supervisor, initialization, and utiUty messages) are 
shown as full messages (message number and text rather than just message 
number). FULLMSG should be included if system commands and/or utiUties are 
to be used on your system. If you include FULLMSG, do not include MINMSG. 

IOS3101 IOS3101 is required if you are using a 3101 in block mode 

(device=acca,mode=3101B). If you include this module, you must include 
lOSACCA as well. 



IOS4974 IOS4974 is optional and is required only if you defined a 4973, 4974, 4975 

(except 4975-OlA), 5219, 5224 and/or 5225 printer using the TERMINAL 
definition statement. 
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Step 3 - Selecting Your Software Support (continued) 

IOS4975A IOS4975A is optional. Include it only if you defined a 4975-OlA ASCII printer using 
the TERMINAL definition statement. If you include this module, $XPSLINK 
automatically includes lOSTERM and lOSACCA. 

IOS4979 IOS4979 is optional and is required only if you defined a 4978, 4979, and/or 4980 

display station using the TERMINAL definition statement. If you included the 
OPTION NOVERLAY Statement, you must include the initialization modules for the 
4978, 4979, and 4980 display stations. For the 4978 and 4979, include INIT4978; 
for the 4980, include INIT4980. 

lOSACCA lOSACCA is required if you defined an ACCA-type terminal with the TERMINAL 

definition statement. For terminals defined as ACCA, the appropriate translation 
tables must be included (see Translation Tables Support). 

Note: You must include this module for the Remote Support Link. Refer to 
Problem Determination Guide for more information about the Remote Support 
Link. 



.i 



ACCATRC ACCATRC is optional and is only required if you want to trace I/O operations and 
interrupts on an ACCA Une with the $traceio utility. In addition, ACCATRC 
enables you to record condition codes, completion codes, ISB and DCB 
information, and status words for a device interrupt from a start cycle steal status 
(SCSS) operation. If you do not include ACCATRC but you do include lOSACCA, 
$XPSLINK automatically includes NOACCATR. 

lOSTERM lOSTERM is required if you defined any of the following devices with the 
TERMINAL definition statement: 



K^y 



• ACCA-type terminal 

• 3101 in character mode 

• Tektronics 40xx. 

Note: You must include this module for the Remote Support Link. Refer to 
Problem Determination Guide for more information about the Remote Support 
Link. 

lOSTTY lOSTTY is optional and provides support for ASR 33/35/3101/3101C TTY 

devices. Include it only if you defined device=tty with the terminal 
definition statement. If you include this module, $XPSLINK automatically includes 
lOSTERM. 

IOS2741 IOS2741 is optional and provides support for 2741 terminals. Include it only if 

you defined DEVICE=2741 with the TERMINAL definition statement. If you 
include this module, $xpslink automatically includes iosterm. 



^ 
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Step 3 - Selecting Your Software Support (continued) 

IOS4013 IOS4013 is optional and provides support for the Tektronix 4000 Series of display 

terminals. Include it only if you defined DEVICE=4013 with the TERMINAL 
definition statement. If you include IOS4013, SXPSLINK automatically includes 
lOSTERM and the initiaUzation module INIT4013. 

lOSGPIB lOSGPlB is optional and provides support for the General Purpose Interface Bus. 

Include it only if you defined DEVICE=GPIB with the TERMINAL definition 
statement. 

lOSSlSl lOSSlSl is optional and provides support for the Series/ 1-to-Series/l 

Attachment. Include it only if you defined device=sisi with the terminal 
definition statement. If you include lOSSlSl, $XPSLINK automatically includes the 
initialization module SISIINIT. 

lOSVIRT lOSVIRT is optional and provides support for virtual terminal communications. 

Include it only if you defined DEVICE=VIRT with the TERMINAL definition 
statement. lOSViRT must be included if you intend to use the Remote 
Management Utility with the PASSTHRU function. 

lOSPOOL lOSPOOL is optional and needs to be included only if printer spooling is to be 
used. 

EBFLCVT EBFLCVT is required for applications that use EBCDIC/floating-point conversion 
and the getedit, putedit, format, fpconv, convtd, or convtb instructions. 
EBFLCVT includes the routines that convert EBCDIC values to floating-point 
values and floating-point values to EBCDIC values. If you include this module, 
include EDXTIO. 

Floating Point Support 

This supervisor object module can be placed in any partition. 

EDXFLOAT EDXFLOAT is required for applications using floating-point data manipulation 
instructions in FORTRAN, Pascal, PL/I or edl. EDXFLOAT processes the Event 
Driven Language floating-point arithmetic instructions. These instructions 
require the floating-point hardware feature. 

If you do not include EDXFLOAT, $XPSLINK automatically includes NOFLOAT. 
NOFLOAT causes an exception condition if a program attempts to execute a 
floating-point instruction. 

Queue I/O Support 

This module can be placed in any partition. 

QUEUEIO QUEUEIO is required for queueing operations which are appUcations that use the 
FIRSTQ, NEXTQ, LASTQ, and DEFINEQ statements. 
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Step 3 - Selecting Your Software Support (continued) 



Binary Synchronous Communications Support 

These supervisor object modules can be placed in any partition. 

BSCAM BSCAM is required if you defined a binary synchronous communication line using 

the BSCLINE definition statement. If you include BSCAM, $xpslink automatically 
includes the initialization module BSCINIT. 

BSCX21 BSCX21 is required to support the X.21 switched network support with binary 

synchronous communication support. To specify retries and delay time, you 
must also include timer support in your supervisor. 



Sensor I/O Support 



These supervisor object modules can be placed in any partition. However, if they are left in 
partition 1, it improves performance. 

SBCOM SBCOM is required to support sensor I/O devices (Al, AO, Dl, DO, or Pi) defined 

with the SENSORIO definition statement. If you include SBCOM, $XPSLINK 
automatically includes ioloader and the initialization module sbioinit. 

SBAI SBAI is optional and is required if you defined analog input support with the 

SENSORIO definition statement. 

SBAO SBAO is optional and is required if you defined analog output support with the 

SENSORIO definition statement. 

SBDIDO SBDIDO is optional and is required if you defined digital input/output support 

with the SENSORIO definition statement. 



if \ 



SBPI 



SBPI is optional and is required if you defined process interrupt support with the 
SENSORIO definition statement. 



System Initialization Support 

These supervisor object modules must be located in partition 1 . 

$PROGl $PROGl is required if you intend to link edit a single application program with the 

supervisor to form a single load module. By doing this, the application program will 
always be resident in storage and will be started automatically after the system and 
user- written initialization is complete. Using $PROGl can be useful if your system 
does not have disk or diskette devices from which to load programs. Refer to the 
Customization Guide for information on writing a program using $PROGl. 

To remove the execution of a disk(ette) -resident program feature from your 
supervisor, do not include RLOADER. If the system-resident disk or diskette volume 
(normally EDX002) exists on the system, delete the transient loader ($loader) 
from it. 
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Step 3 - Selecting Your Software Support (continued) 

IO1024 IO1024 is optional and is required only if you intend to IPL your system from a 
1024-bytes/sector diskette. It must be included before EDXINIT. 

System Support - Initialization 

These modules must be located in partition 1 . 

EDXINIT EDXINIT is a required module and must be included in every supervisor. It must 

appear in this location. 

EDXINIT is the system initialization routine and executes all the initialization 
modules. 

Note: If you intend to add your own operator command, user attention list, or 
device support, the include statement and module name must be placed before 
EDXINIT. For information on adding your own operator command, see 
Customization Guide. 



RW4963ID RW4963ID is required to initialize a 4963 disk with fixed-head support and is 
defined with the DISK definition statement. Include this module only if you 
specify OPTION NOVERLAY. 

INITADAP INITADAP is required to initialize the Printer Attachment - 5200 Series (feature 
#5640) and the Multidrop Work Station Attachment (feature #1250) defined 
with the ADAPTER statement. Include this module only if you specify OPTION 

NOVERLAY. 



INITMFA INITMFA is required to initialize a Multifunction Attachment Feature #1310 

defined with the ADAPTER definition statement. Include this module only if you 
specify OPTION noverlay. 

INIT4978 INIT4978 is required to initialize the 4978 and 4979 display terminals defined with 
the terminal definition statement. Include this module only if you specify 

OPTION NOVERLAY. 

INIT4980 INIT4980 is required to initialize the 4980 display station defined with the 

TERMINAL definition statement. Include this module only if you specify OPTION 

NOVERLAY. 
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Step 3 - Selecting Your Software Support (continued) 

User-Written Initialization Modules 

You may want to write your own device-initialization routines. If you do, you can include them 
at this location or preceding the edxinit module. However, if you include them preceding the 
EDXINIT module, the initialization routines will remain resident in your supervisor. For 
information on writing your own initialization routines, see the Customization Guide. 

In addition, you have the option of defining your own device-initiaUzation routines as overlay 
segments. An overlay segment consists of an OVERLAY statement and the INCLUDE statements 
associated with it. Each segment is ended by the next OVERLAY statement or PART statement. 
Generally, each initialization routine is a separate overlay segment (one overlay statement and 
one INCLUDE statement). However, you can define multiple routines in one overlay segment if 
you wish. See the $EDXLINK utility in the Operator Commands and Utilities Reference for an 
explanation of the overlay statement. 

If you do not want to define your device-initialization routines as overlay segments, specify only 
the INCLUDE statements for each initiaUzation routine. 

Object Modules to be Located Outside of Partition 1 

If you are going to generate a multipartition supervisor, you must locate object modules outside 
of partition 1 . The PART statement preceding a group of modules specifies the partition where 
the modules are to be located. Each group of modules to be located outside of partition 1 must 
be moved in the $LNKCNTL data set to this location. 



LINK Statement 



The LINK statement is a required link-control statement used to define the name of the data set 
where the generated supervisor is to be stored. The name of the data set is $edxnuct in the 
$LNKCNTL data set. As shown in work sheet 3, the name of the supervisor is part of the 
$XPSLINK LINK Statement and must be specified. The generated supervisor will be stored on 
EDX002. The REPLACE Option causes the linkage editor to replace any program on the same 
volume with the same name as the one specified in the LINK statement. The END option ends 
the linkage editor operation upon completion of link. 

The $edxnuct data set is allocated automatically by $xpslink. You may wish to change this 
name to $EDXNUCx (x = any alphameric character) to save different supervisor versions in 
individual data sets. However, if you do change the data set name, be sure the supervisor name 
starts with the seven characters $edxnuc and that the name is different from the name of the 
current supervisor. 



\J 
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Step 3 - Selecting Your Soft\A/are Support (continued) 

Define an Overlay Area 

An overlay area is an area in storage that is used to execute overlay segments. There are two 
ways to create an overlay area in your operating system: 

1 . You can allow the supervisor to create the overlay area for you. The supervisor creates the 
overlay area directly after the supervisor area in partition 1 . This is the default. 

Example: The supervisor program creates the overlay area. In the link-control data set, the 
OPTION NOVERLAY and OVLAREA Statements must be commented out with an asterisk (*). 






'OPTION NOVERLAY 
'SUPERVISOR SUPPORT 



>25" NO OVERLAY STRUCTURE 
- MUST BE FIRST AND IN PARTITION 1 



PARTI 

VOLUME XS5002 DEFAULT VOLUME FOR INCLUDE MODULES 

'OVLAREA OVLSTART OVLEND "23" USER DEFINED OVERLAY AREA 

INCLUDE EDXSYS *1* SYSTEM TABLES AND WORK AREAS 



INCLUDE EDXINIT 



INITIALIZATION 

"2i»" SUPERVISOR INITIALIZATION 



The overlay area created by the supervisor appears in storage as follows: 
Partition 1 



SupLM visor 



Overlay area 



End of supervisor 
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Step 3 - Selecting Your Software Support (continued) 

2. You can define the overlay area by including the ovlarea statement in the link-control data 
set. 



The OVLAREA statement defines the overlay area within the storage in partition 1 occupied 
by the supervisor. OVLSTART indicates the starting address of the overlay area, ovlstart is 
a pointer to the beginning of the seginit module within the supervisor which is equated to 
diskbufr+12 bytes, ovlend indicates the end of the overlay area, ovlend is a pointer to 
the end of the DISKINIT module within the supervisor. 

However, you can specify any starting and ending address for the overlay area, but the size 
of the overlay area must be larger than the largest overlay segment included. If the overlay 
area is not large enough, $xpslink issues the following message: 



OVERLAY AREA IS TOO SMALL, SIZE REQUIRED IS xxxx HEX 



where xxxx indicates the required size of the overlay area in hexadecimal. Respecify the 
starting and ending points of the overlay area and Unk edit the definition statements with the 
Unk-control data set. 

Example: Define the overlay area to be within the storage in partition 1 occupied by the 
supervisor. In this case, remove the asterisk (*) from the OVLAREA statement and leave the 
asterisk (*) on the option noverlay statement. 



^OPTION NOVERLAY 
'SUPERVISOR SUPPORT 



"25" NO OVERLAY STRUCTURE 

- MUST BE FIRST AND IN PARTITION 1 



PARTI 

VOLUME XS5002 DEFAULT VOLUME FOR INCLUDE MODULES 

OVLAREA OVLSTART OVLEND "23" USER DEFINED OVERLAY AREA 
INCLUDE EDXSYS "1" SYSTEM TABLES AND WORK AREAS 



INCLUDE EDXINIT "24" SUPERVISOR INITIALIZATION 
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Step 3 - Selecting Your Software Support (continued) 

The overlay area appears in storage as follows: 
Partition 1 



Supervisoi 



OvL'tlav <ited 



■OVLSTART 
OVLEND 



-* — End of supervisor 



^r*x„ 



In both cases, an area of storage in partition 1 is defined as an overlay area. The overlay area is 
large enough to contain the largest initialization routine. 

Including Initialization Routines in Your Supervisor 

Initialization routines are supervisor object modules that prepare I/O devices for operation. The 
linkage editor, $XPSLINK, automatically includes the initialization routines required for your 
system configuration in your supervisor. However, by excluding or including certain statements 
in the link-control data set, initialization routines are treated either as overlay segments or as 
resident programs. 

Initialization Routines as Overlay Segments 

To include initialization routines as overlay segments, you do not need to include any statements 
in the link-control data set. The linkage editor builds the supervisor to default to an overlay 
structure. As a result, $XPSLINK includes the required initialization routines as overlay segments. 
This means that each initialization routine is executed one at a time in the storage defined as the 
overlay area. 

Initialization Routines as Resident Programs 

To include initialization routines as resident programs, you must include the option noverlay 
statement. The linkage editor builds the supervisor without an overlay structure and 
automatically includes the initialization routines required for your system configuration as 
resident programs. In this case, the required initialization routines are loaded simultaneously in 
supervisor storage at ipl time. As a result, the initialization routines increase the amount of 
storage that the supervisor requires in partition 1 . 
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Step 3 - Selecting Your Software Support (continued) 

If you include the OPTION NOVERLAY statement when tailoring a system for use on a 4952, 
4954, 4955, or 4956 processor, the following five initialization routines are not included 
automatically by the linkage editor: 

. RW4963ID 

. INITMFA 

. INITADAP 

. INIT4978 

. INIT4980. 

You must include each of the above modules specifically if you require them as part of the 
supervisor. 

The RW4963ID, INITMFA, INITADAP, INIT4978, and INIT4980 modules do not appear in the 
link-control data set, but do appear in work sheet 3. You must add them to the link-control data 
set directly following the edxinit module. 

Example: Include the option noverlay statement and the initialization modules that are not 
included automatically by the Unkage editor (overlay is the default). 

OPTION NOVERLAY "25" NO OVERLAY STRUCTURE 

a. 

"SUPERVISOR SUPPORT - MUST BE FIRST AND IN PARTITION 1 



PARTI 

VOLUME XS5002 DEFAULT VOLUME FOR INCLUDE MODULES 

^OVLAREA OVLSTART OVLEND "23" USER DEFINED OVERLAY AREA 
INCLUDE EDXSYS "1" SYSTEM TABLES AND WORK AREAS 



k_ 



" SYSTEM 


SUPPORT -- 


INITIALIZATION 


AAAAAAAA5' 


tAAAAAA;VAAA: 


JLJLjtAJL^JLjLJUXX^^XJ-J-^LJ-XXjLJ-JjjUA 


INCLUDE 


EDXINIT 


"2^" SUPERVISOR INITIALIZATION 


INCLUDE 


RW't963ID 


"3" ^963 FIXED HEAD REFRESH SUPPORT 


INCLUDE 


INITMFA 


"3* MFA INITIALIZATION 


INCLUDE 


INITADAP 


"3" ALPA & SMIO INITIALIZATION 


INCLUDE 


INITA978 


*3" A978 DISPLAY INITIALIZATION 


INCLUDE 


INIT^gSO 


"3" A98O DISPLAY INITIALIZATION 
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Initialization IVIodules 



The following is a list of the initialization modules that are included in your supervisor, if 
required, by the Unkage editor, along with an explanation of each. This list is provided for 
information only as the initiaUzation module names may appear in the link map when you 
generate your system. 

Module Description 

BSCINIT BSCINIT is required to initiaUze a binary synchronous line defined with the 

BSCLINE definition statement. 

CLOKINIT CLOKINIT is required to initialize the native timer on the 4952, 4954, or 4956 
processors. 

DSKINIT2 DSKINIT2 is required to initialize fixed-head disk device(s) defined with the DISK 
definition statement, set attention for 1024-bytes-per-sector diskettes, and issue 
the IPL volume message. 

EXIOINIT EXIOINIT is required to initialize I/O devices defined with the EXIODEV definition 
statement. 

INITADAP INITADAP is required to initialize the Printer Attachment Feature #5640 and the 
Multidrop Work Station Attachment Feature #1250 defined with the ADAPTER 
definition statement. 

INITMFA INITMFA is required to initialize the Multifunction Attachment Feature #1310 
(mfa) defined with the ADAPTER definition statement. 

INIT4013 INIT4013 is required to initialize a Tektronics 4013 Graphics Terminal defined 

with the TERMINAL statement. 

INIT4978 INIT4978 is required to initialize 4978 and 4979 display terminals defined with the 
TERMINAL definition statement. 

INIT4980 INIT4980 is required to initialize 4980 display terminals defined with the 

TERMINAL definition statement. 

LOADINIT LOADINIT is required if programs are to be loaded from disk or diskette. 

RW4963ID RW4963ID is required to initialize a 4963 disk with fixed-head support and is 

defined with the DISK statement. You must include DSKINIT2 in the same overlay 
area. 

SBIOINIT SBIOINIT is required to initialize sensor-based I/O devices defined with the 
SENSORIO definition statement. 
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Step 3 - Selecting Your Software Support (continued) 

STORINIT STORINIT is required to initialize the unmapped storage tables in your system if 
you have defined unmapped storage. 

SISIINIT SlSllNiT is required to initialize the Series/ 1-to-Series/l attachment defined with 
the TERMINAL definition statement. lOSSlSl must be included (see Terminal 
Support). 

TAPEINIT TAPEINIT is required to initialize a 4968 or 4969 tape unit defined with the tape 
definition statement. 

TERMINIT TERMINIT is required to initialize any terminals defined with the terminal 
definition statement. 

TIMRINIT TIMRINIT is required to initialize the #7840 timer on the 4955 processor. 

TPINIT TPINIT is required to initialize the Host Communications Facility defined with the 

HOSTCOMM definition statement. 



Step 4 - Defining Supervisor Structure 

In "Step 1 - Estimating Total Supervisor Size" on page IS-42, you estimated the total size of 
your supervisor. If your supervisor size is 64K or greater or you want to free up storage in /f ^ 

partition 1 in order to have space available for additional I/O devices or program execution, you \_# 

need to reduce the size of the supervisor in partition 1 . 

Reducing the Size of Your Supervisor 

There are three ways to reduce the size of your supervisor: 

1 . The first way is to minimize the amount of storage in partition 1 used by the initialization 
routines by treating them as overlay segments. An initialization routine is an edx program 
used to set up the necessary internal controls to make a device active. An overlay segment 
is a portion of a program that is read from disk, executed, and released. 

To do this, an area of storage within partition 1 is defined as an overlay area and is large 
enough to contain the largest initialization routine. At IPL time, each initialization routine is 
brought into storage one at a time in the same storage area thereby reducing the amount of 
storage required. 

2. The second way is to break your supervisor into several parts. Your supervisor is a program 
that is made up of many smaller programs called object modules. Some of these modules 
can be moved to partitions other than partition 1 . If you move part of the supervisor to 
another partition, you reduce the size of the supervisor remaining in partition 1 . For 
example, if your supervisor is approximately 48K bytes in size and you move several parts 
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Step 4 - Defining Supervisor Structure (continued) 

that equal 8K bytes in size, the size of the supervisor remaining in partition 1 is 40K (48K - 
8K = 40K). 

By locating the supervisor in more than one partition, you need less storage for it in 
partition 1 . This leaves more storage available in partition 1 for support of additional I/O 
devices or to execute application programs within partition 1 . However, by placing parts of 
the supervisor in other partitions, the amount of storage within those partitions available for 
program execution is reduced. 

3. The third way is a combination of (1) and (2) above; that is, treat initialization routines as 
overlay segments and spread the supervisor across more than one partition. 

Any storage within each partition not containing part of the supervisor is available for execution 
of appUcation programs, program products, and utility programs. Depending upon your 
processor type, your supervisor can support processor storage sizes from 64K bytes (IK = 1024 
bytes) to 1024K bytes with unmapped storage support. 

In the SYSTEM definition statement, you define the partition structure and the amount of storage 
assigned to each partition through the PART= operand. You also define the number of programs 
that can execute concurrently in each partition through the maxprog= operand. In order to 
define these characteristics, you need to make a couple of decisions: 

1 . What portion of each partition will be used by the supervisor. 

2. How much storage is left within each partition for the execution of programs. 

To help you make these decisions, use work sheet 4 in Appendix E. Work sheet 4 is made up of 
two parts: A and B. 

Part A - Estimate Storage Needed by Supervisor Object Modules 

Part A lists the approximate sizes (in bytes) of the supervisor object modules. Under 
'PARTITION ONE' is a list of modules that must reside in partition one. Under 'PARTITION any' 
are the names of modules that can be placed in partitions 2 through 8 (depending upon your 
processor). However, some of these modules must be grouped together. These subgroupings are 
shown on the work sheet. 

By determining which modules you want to place in partitions 2 through 8, you can estimate 
how much storage these modules will occupy in a partition. The storage remaining in each 
partition is available for other programs. In addition, by totaUng the number of bytes of these 
modules, you can estimate the reduction in size of that part of the supervisor remaining in 
partition 1. 
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Step 4 - Defining Supervisor Structure (continued) 

Part B - Estimate Storage Needed by Other Programs 

Part B lists the amount of storage required by the supervisor to support program products, 
application programs, and utility programs. These programs, although not part of your 
supervisor, use storage within the partition where they are loaded. To determine how many 
programs you can execute concurrently within a partition, you need to know how much storage 
is required by each program. An estimate of more than 64K or 65536 bytes for a specific 
program indicates that it will not be able to execute within one specific partition. 

The approximate size (in bytes) of each system utility program is shown. You may or may not 
use all of the utiUty programs. However, you should make sure that your partitions are large 
enough to hold the largest utility program you plan to use along with other programs. 

After you determine which object modules you are moving out of partition 1 , the amount of 
storage left in each partition for program execution, and the maximum number of programs you 
can execute within each partition, you may need to redefine the following: 

Work Sheet 2 The PARTS = and maxprog= operands of the system definition statement. 

Work Sheet 3 The PART link-control statement indicating which modules are being moved 
from partition 1 and the partition where they will be located. 



Work Sheets for the Sample System 



Following are samples of work sheets 2 and 3 that reflect the hardware and software features of 
the sample system defined in the beginning of the chapter. 

"Work Sheet 2 for Sample System" on page IS-71 shows the definition statements defining the 
devices and "Work Sheet 3 for Sample System" on page IS-73 shows the software support 
selected. 
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Work Sheet 2— Installation and System Generation 



SYSTEM DEFINITION STATEMENTS 
Storage definition 

blank SYSTEM MAXPROG= 

PARTS= 

DATEFMT= 
IABUF= 
XPSSTK= 
COMMON= 

INITPRT= 

INITMOD= 

MECBLST 



z 



^3^ 



/O /O _dl 



~:^¥' /e : .^o 



Disk(ette) definition 

blank DISK 



DEVICE=4962,-//=" 
ADDRESS= OS 
VOLNAME= ( 
TASK= /^S 
END= 



blank DISK 



DEVICE=4964, 
ADDRESS= 
TASK= 
END= 



2. 


4973/4974 Printers 




o 

5d 


Jeher TERMINAL 


DEVICE= 

ADDRESS 

PAGSIZE= 


z 




LINSIZE= 


q- 




TOPM= 


o. 

c 




BOTM= 
LEFTM= 


o 




RIGHTM= 


3- 




OVFLINE= 


GO 




SPOOL= 
END= 



_a2_ 
yes 
res 






REQUIRED/OPTIONAL/DEFAULTS 

Optional-defaults to 10 

Optional-defaults to 32K 

Optional-defaults to MMDDYY 
Optional-defaults to 20 
Optional-defaults to 20 
Optional-defaults to EDXSYS 

Optional-defaults to 1 

Optional 

Optional 



Required 

Required 

Optional 

Optional-defaults to NO 

Optional-defaults to NO 



Required 
Required 

Optional-defaults to NO 
Optional-defaults to NO 



Required (specify 4973 or 4974) 
Required 



Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
(Specify YES if last TERMINAL statement) 



onal 

onal 

onal 

onal 

onal 

onal 

onal-defaults to NO 

onal-defaults to NO 

onal-defaults to NO 



u 

^ 


o 


TT 


^ 


(fi 


^ 


3- 

(D 
(D 


CO 

3" 


r+ 


CD 


N> 


(D 


-h 


I-+ 


o 


cn 


^ 






■4% 


C/) 

0) 


O 


^ 


i-K 


T3 


3" 


(D 


(D 


C/) 

< 
(A 


CO 




3 

CD 
CO 

< 
(A 

»-► 
(D 

3 

o 

CD 



-J 



4978/4979 Terminals 
-Ubai. TERMINAL 



DEVICE= 

ADDRESS^ 

PAGSIZE- 

LINSIZE= 

TOPM= 

BOTM= 

NHIST= 

LEFTM= 

RJGHTM= 

OVFLINE= 

HDCOPY= 

ATTN= 

PF1 = 

SCREEN= 

PART= 

SPOOL= 

END= 



0^ , 



Required (specify 4978 or 4979) 
Required 



s^^^m^, 



Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 



onal 

one! 

onal 

onal 

onal 

onal 

onal 

onal-defaults to NO 

onal 

onal-defaults to YES 

onal-(2 digit hex char) 

onal-(YES/NO/STATIC) 

onal-defaults to partition 1 

onal-defaults to NO 

onal-defaults to NO 



(Specify YES if last TERMINAL statement) 






System common 



$SYSCOM 



CSECT 



$EDXPTCH 




A/O/VS" ^^^-/^/A/^^ 



SEDXPTCH 
128F'0' 



System Patch Area 



o 

CD 
CD 



3" 
CD 

CO 

0) 

3 



CO 

< 

(0 

CD 

3 

s: 



CO 

2- 

CD 

o 

< 

o 



7) 

CD 

13 



CD 

Q. 

CO 

c 
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o 
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Work Sheet 3 for Sample System 
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To include a supervisor object module in your operating system, leave Column One blank. To exclude a 
module, place an asterisk (*) in Column One. 


Column 
one 


Supervisor 
object modules 


Notes 


Purpose of module 


>^ 


OPTION NOVERLAY 


*25* 


No overlay structure 


Supervisor support-must be first and in partition 1 | 




PART 1 








VOLUME SX4002 




Default volume for include modules 


9^ 


OVLAREA OVLSTART OVLEND 


*23^ 


User defined overlay area 




INCLUDE EDXSYS 


*.,* 


System tables and work area 




INCLUDE ASMOBJ,EDX002 


*1* 


Output from user system generation 




INCLUDE EDXSVCX 


*1* 


Task supervisor 


^ 


INCLUDE $DEBUGNUC 


*2* 


Resident $DEBUG support 




INCLUDE EDXALU 


*1* 


EDL instruction emulator 




INCLUDE EDXSTART 


•l* 


Initialization & error handler 


^ 


INCLUDE SWAITM 


*3* 


Wait on multiple events 


Timer sup 


3ort— must be in partition 1 1 


^ 


INCLUDE EDXTIMER 


*12' 


4955 timer (7840) support 


^ 


INCLUDE EDXTIMR2 


*12* 


4952/4954/4956 timer support 


EX 10 support— must be in partition 1 




-J^ 


INCLUDE lOSEXIO 


*3* 


EXIO device control support 


^ 


INCLUDE EXIOTRC 


*3* 


EXIO trace option 


Error logging— must be in partition 1 | 


A- 


INCLUDE SYSLOG 


*3* 


I/O error loqqinq 


^ 


INCLUDE CIRCBUFF 


*16* 


Program/machine check loqqinq 


Optional function support— must be in partition 1 I 


^ 


INCLUDE RLOADER 


*17* 


Relocating program loader 


-Xr 


INCLUDE STORMGR 


*3* 


Unmapped storage manager support 


-^ 


INCLUDE lAMOCB 


*20* 


lAMQCB needed for lAM support 


^ 


INCLUDE PWRAM80 


*26* 


4980 Power on RAM 


Host communications support— must be in partition 1 1 


-^ 1 INCLUDE TPCOM | *14* 


Host communication support | 


Translation tables— must be in partition 1 1 


4f- 


INCLUDE TRASCII 


*10* 


1310,2095/2096.7850 ACCA/TTY translation 


^6 


INCLUDE TREBASC 


*10* 


1610,2091/2092 ACCA translation 


^t 


INCLUDE TREBCD 


•11* 


2741, PROC EBDC translation 


4r 


INCLUDE TRCRSP 


*11* 


2741 correspondence translation 


Disk(ette) and tape support-must be grouped together in 


any partition 




PARTI 








INCLUDE DISKIO 


*3* 


Basic disk(ette) support 




INCLUDE D49624 


*3* 


4962/4964 disk(ette) support 


^ 


INCLUDE D4963A 


•3* 


4963/4967/DDSK-30 subsystem suooort 


> 


Ir 


INCLUDE D4966A 


•3* 


4965/4966 disk(ette) support 


A 


i 


INCLUDE D1024 


*3.21* 


1024 bytes/sector 10 support 


*• 


INCLUDE D4969A 


*3* 


Basic tape support 


Terminal— must be grouped toqether in any partition 1 




PART^g; 








INCLUDE EDXTIO 


*4* 


Basic terminal support 


46 


INCLUDE MINMSG 


*5* 


Message 1 D only support 




INCLUDE FULLMSG 


♦5* 


Message data set support 


^ 


INCLUDE IOS3101 


*7* 


ACCA3101BsuDDort 




INCLUDE IOS4979 


*3* 


4978/4979/4980 display support 
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Work Sheets for the Sample System (continued) 



i^£?l Series/1 Event Driven Executive 



Work Sheet 3— Installation and System Generation (cont.) 


Column 
one 


Supervisor 
object modules 


Notes 


Purpose of module 




INCLUDE IOS4974 


*3* 


4973/4974/4975/5219/5224/5225 printer support 


-V- 


INCLUDE lOSACCA 


*4* 


ACCA device handler 


•^ 


INCLUDE ACCATRC 


*3* 


ACCA trace option 


5- 


INCLUDE lOSTERM 


*A,6* 


ACCA/TTY/2741/4013 support 


^ 


INCLUDE lOSTTY 


*3* 


ASR 33/35/3101/3101C TTY support 


4t 


INCLUDE IOS2741 


*3* 


2741 terminal support 


3^ 


INCLUDE IOS4013 


*3* 


Digital I/O terminal support 


4? 


INCLUDE lOSGPIB 


*3* 


GPIB support 


^ 


INCLUDE I0SS1S1 


*3* 


Series/1 -Series/1 support 


^ 


INCLUDE lOSVIRT 


*3,9* 


Virtual terminal support 


^ 


INCLUDE lOSPOOL 


*3* 


Spooling support 


^ 


INCLUDE EBFLCVT 


*18* 


EBCDIC/floating point conversion 


Floating point-may be in any partition | 


^^ 


PARTI 






ii- 


INCLUDE EDXFLOAT 


*3* 


Floating point arithmetic 


Queue I/O— may be in any partition | 


r^e 


PART1 






4^ 


INCLUDE QUEUEIO 


*19* 


Queue processing support 


Bisync communications-may be in any partition | 


-^ 


PART1 






5. 


INCLUDE BSC AM 


*13* 


Bisync communication support 


^ 


INCLUDE BSCX21 


*27* 


Bisync communication support for X.21 


Sensor input/butput-must be grouped together ir 


any partition | 


^ 


PARTI 






Ti 


INCLUDE SBCOM 


*15* 


Basic sensor I/O support 


iK^ 


INCLUDE SBAI 


*3* 


Analog input support 


f^ 


INCLUDE SBAO 


*3* 


Analog output support 


^ 


INCLUDE SBDIDO 


*3* 


Digital input/output support 


¥r 


INCLUDE SBPI 


*3* 


Process interrupt support 


System initialization-must be in partition 1 | 


¥r 


INCLUDE SPROGl 


*22* 


User module included in nucleus qen 


^ 


INCLUDE IO1024 


*21* 


1024 1 PL support 


System support -- initialization-must be in partition 1 | 




INCLUDE EDXINIT 


*24* 


Supervisor initialization 


^ 


INCLUDE RW4963ID 


*3* 


4963 fixed head refresh support 


ih 


INCLUDE INITMFA 


•3* 


MFA attachment initialization 


4t 


INCLUDE INITADAP 


*3* 


ALPA and SMIO initialization 


¥r 


INCLUDE INIT4978 


*3* 


4978/4979 terminal initialization 


^ 


INCLUDE INIT4980 


•3* 


4980 display initialization 
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Work Sheets for the Sample System (continued) 



E s~£ =^= 


: Series/1 Event Driven Executive 


Work Sheet 3— Installation and System Generation (cont.) 


Column Supervisor 
one object modul^es 


Notes 


Purpose of module 


Insert user initialization modules here | 
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Work Sheets for the Sample System (continued) 



= • = 


Series/1 Event Driven Executive 


Work Sheet 3— Installation and System Generation (cont.) 


Column Supervisor 
one object modules 


Notes Purpose of module 


Supervisor code being moved out of partition 1 must be moved to here | 




.^AT- 8 








yA/d^UO^" £^£>)Cr/0 


>f-^^ 


SAS/a. -T^RZ-Z/ACAA. ^l^T^yO/ST' 




y5V<2y//Z>^ ^U^MA^S^ 


^^■^ 


^/JU. /^£SSA£^ ^6/7'?=^/^T 




/A/r.^LfO£ /as^^T^ 


Ml3^ 


^*^7£>/^ff^r7^Z>>i57>y^^<yy7>^^i>;^y 




//\/A/.6^£>S' yOS^^T'^ 


Hf^^ 


-*«*^5«^/^^7'-<^<ftr:7'^ 7^y/i/7:e:^.Si^^Pti^^7- 










































































































































































































































































































































Locat.onjiU*,H»«agfii^— -5>. ^ S'£»(A^£^CJ2 


LINiy$EDXNUCTiDX002 REPLACE END 



o 
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Chapter 5. Generate a Tailored Operating 

System 



This chapter provides the step-by-step procedures for generating a tailored operating system. In 
order to generate an operating system, you should have completed work sheet 2 and work 
sheet 3. Work sheet 2 contains the system definition statements that define processor storage 
and the devices attached to your Series/ 1. Work sheet 3 defines the software features (object 
modules) you should include in your supervisor to support the I/O devices defined. 

Note: Before you generate a tailored operating system, EDX must be installed as described in 
Chapter 3, "Install EDX" on page IS-11. 

The following is a summary of the steps you must perform to generate a tailored operating 
system: 

Step 1 IPL the starter system from disk. 

Step 2 Allocate required data sets. 

Step 3 Edit $EDXDEF on volume ASMLIB to specify the system definition statements to match 
your hardware requirements. 

Step 4 Edit $LNKCNTL on volume ASMLIB to specify which object modules are to be included 
in your supervisor. 

Step 5 Edit $JOBUTlL procedure file ($SUPPREP on volume ASMLIB) to use the data sets 
allocated in Step 2. 
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Step 6 Execute $supprep. Use the $jobutil utility and the job stream procedure created in 
Step 5 to: 

• Compile the system definition statements created in Step 3. 

• Link edit the resulting object module, using the link edit control data set created in 
Step 4. 

• Store your tailored operating system in a data set named $EDXNUCx on EDX002. 
Step 7 Use your tailored operating system. 

Step 8 Verify the system generation process (optional). 

To perform these steps, you use the following utilities: 

$DISKUT1 $DISKUT1 is used to allocate the data sets required in Step 2. 

$FSEDIT $FSEDIT is used to edit various data sets and to enter definition statements. 

$INITDSK $INITDSK is used to initialize devices and tailored supervisors and to allocate and 
initiahze volumes. 

$JOBUTIL $JOBUTlL is used to execute the procedure data set. /(r~^\ 

$EDXASM $EDXASM is used to compile the supervisor definition data set (invoked by the 
procedure data set). 

$XPSLINK $XPSLINK is used to link edit and format the supervisor (invoked by the procedure 
data set). 



Step 1 - IPL the Starter System from Disk 

The first step in generating your tailored operating system is to IPL the starter system you 
previously installed on disk. To IPL the starter system installed in Chapter 3, "Install EDX" on 
page IS- 11, press the LOAD button on the system console. 

Once your system is up and running, you can begin generating your tailored operating system. 



c 
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Step 2 - Allocate Required Data Sets 



The system generation process requires the use of several system utility/program preparation 
programs. These programs require data sets for use as work areas or input/output data sets. 
You must allocate the four data sets on volume EDX002 before you can generate a tailored 
operating system. 

Note: In Chapter 3, "Install EDX" on page IS-1 1, it is suggested in step 7 that you assemble 
the sample program CALCSRC to verify starter supervisor installation. If you performed that 
step, EDITWORK, ASMOBJ, ASMWORK, and LINKWORK have already been allocated and need not 
be allocated here. Proceed to step 3. 

The recommended size and required organization type of each data set is shown below. 



Data set 
name 


Size 

(number of records) 


Organization 
type 


EDITWORK 


200 


D (data) 


ASMWORK 


500 


D (data) 


ASMOBJ 


300 


D (data) 


LINKWORK 


600 


D (data) 






'>^ 



F^^ure 6. Required data sets for system generation 
Notes: 

1 . The size of ASMOBJ depends on the size of the supervisor being generated. To determine the 
size (in records) of asmobj, divide the estimated supervisor size (in bytes) by 256 to get the 
number of records required. 

2. LINKWORK must be at least 600 records. If an end of file (eof) occurs during the link step, 
the data set is too small. You then must delete and reallocate the data set specifying a larger 
size. 

3. See $DISKUTl in Operator Commands and Utilities Reference or Operation Guide for an 
explanation of organization types and instructions for allocating data sets. 

To allocate the data sets, press the attention key and load $diskuti. Respond to the $diskuti 
prompts as shown. 



.#y 
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Step 2 - Allocate Required Data Sets (continued) 



> $L $DISKUT1 

LOADING $DISKUT1 63P, LP= 9100, PART=1 

$DISKUT1 - DATA SET MANAGEMENT UTILITY I 

USING VOLUME EDX002 

COMMAND (?): AL EDITWORK 200 D 
EDITWORK CREATED 

COMMAND (?): AL ASMWORK 500 D 
ASMWORK CREATED 

COMMAND (?): AL ASMOBJ 300 D 
ASMOBJ CREATED 

COMMAND (?): AL LINKWORK 600 D 
LINKWORK CREATED 

COMMAND {?): EN 

$DISKUT1 ENDED 



^\_/ 



EDITWORK is the name of a work data set that is required by the $FSEDIT text editing 
utility. 

These data sets are used by the $edxasm compiler. ASMOBJ is the data set in which the 
object module output of the compiler will be stored. ASMWORK is an assembler work 
data set. 






Q LINKWORK is the $xpslink Hnkage editor work data set. 

If you plan to use the $editin utiUty to edit $edxdef and $lnkcntl, you must also allocate the 
following data sets on volume EDX002: 

• $EDXDEFS at 20 records 

• LINKCNTL at 1 1 1 records 

• SUPPREPS at 15 records 
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Step 3 - Edit Definition Statements to Match Hardware Configuration 

Work sheet 2 contains the system definition statements that define the characteristics of 
processor storage and the I/O devices attached to your Series/ 1. During the installation 
procedure, a data set containing the definition statements was copied to volume EDX002 on disk. 
You must modify the system definition statements in this data set to match your hardware 
configuration. 

For the starter system, this data set is named $edxdef. 

To edit the definition statement data set: 



3(a) Press the attention key and load the $FSEDIT utility. Respond to the $FSEDIT prompts 
as shown. 



r 



> $L $FSEDIT 

WORKF I LE ( NAME , VOLUME ) : EDI TWORK ,EDX002 

LOADING $FSEDIT 89P , LP= 9200, PART= 1 

DS1 HAS NOT PREVIOUSLY BEEN USED 

AS A WORK DATA SET 

IS IT OK TO USE IT NOW (Y/N)? Y 



^ 



Note: The first time you use EDITWORK as a work file for the text editor, $FSEDIT, you 
are asked if you can use the edit work data set as a work data set; respond YES and 
continue. 



Once loaded, $FSEDIT displays the primary option menu. 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 

DATA SET NAME =========> 

VOLUME NAME ==========> 



-STATUS = 

PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



HOST DATA SET =========> 

ENTER A VOLUME NAME AND PRESS ENTER FOR A DIRECTORY MEMBER LIST 



BROWSE 

EDIT 

READ (HOST/NATIVE) 

WRITE (HOST/NATIVE) 

SUBMIT BATCH JOB TO HOST SYSTEM 

PRINT 

MERGE 

END 

HELP 



J 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 



3(b) Read a copy of the definition statement data set into the work data set. 

1 . Enter a 3 on the COMMAND line. 

2. Enter the name of the definition statement data set on the DATA SET NAME line: 
Enter $EDXDEF to modify the starter system definition statements. 

3. Enter EDX002 on the volume name line. 



r 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 3 

DATA SET NAME =========> $EDXDEF 

VOLUME NAME ==========> ASML I B 



-STATUS = 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



>v 



Press the enter key. $FSEDIT reads the requested data set into the work data set and 
issues the following message: 



L 



109 LINES READ FROM $EDXDEF ,ASML I B 



3(c) Select option 2 (EDIT) to edit $EDXDEF. Enter a 2 on the OPTION line. 



r 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 2 

DATA SET NAME =========> SEDXDEF 

VOLUME NAME ==========> ASML I B 



-STATUS = 

PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



J 



A 



Press the enter key. $fsedit displays the contents of the data set. Figure 7 on page 
IS-83 shows the contents of $EDXDEF. 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 






$EDXDEF CSECT 

$ID 
" XPS 

" EVENT DRIVEN EXECUTIVE 

" VERSION 5, MODIFICATION LEVEL 

a. 

" THE FOLLOWING DEFINES THE STARTER SUPERVISOR AS SHIPPED ON THE 

* DISKETTE LABELED XS5001. FOR COMPLETE DESCRIPTIONS OF THESE 

" STATEMENTS OR ANY OTHER SYSTEM DEFINITION STATEMENTS, REFER TO 

" THE INSTALLATION AND SYSTEM GENERATION GUIDE, SC3^-06A6. 

JU 

" ONLY STATEMENTS WITHOUT AN ASTERISK (*) IN COLUMN 1 ARE ASSEMBLED, 





BASIC 


STORAGE DEFINITIONS 






J. 


PARTITION NUMBER: 12 3^567 
SYSTEM MAXPROG=(05,05,05,05,05,05,05. 
PARTS=(32,32,32,32,32,32,32, 


8 9 
,05), 
.32) 


10 11 12 13 14 15 16 

C 


JL 


BASIC 


DEFINITION FOR A 4969 TAPE 






a. 




TAPE DEVICE='t969,ADDRESS=i*C,ID=TAPE01 , 
DENS ITY=1 600, LABEL=SL,TASK=YES 


c 


JU 
JL. 


BASIC 


DEFINITION FOR A 4962-1 OR -2 DISK 




(9.3 MB) 


JU 




DISK DEVICE=4962-1F,ADDRESS=03 






JU 


BASIC 


DEFINITION FOR A 4963-23 DISK 




(23 MB) 






DISK DEViCE=4963-23,ADDRESS=48 






JU 

a. 


BASIC 


DEFINITION FOR A 4967-2 OR -4 DISK 




(200 MB) 






DISK DEVICE=4967-2,ADDRESS=48 






J. 


BASIC 


DEFINITION FOR A DDSK-30 DISK 




(30 MB) 


a- 




DISK DEVICE=DDSK-30,ADDRESS=44 






A 


DISKETTE DEFINITIONS 







DISK DEVICE=4964,ADDRESS=02 

DISK DEVICE=4965,ADDRESS=44 

DISK DEVICE=4965,ADDRESS=45 

D I SK DEV I CE=4966 ,ADDRESS=22 ,END=YES 



Figure 7 (Part 1 of 3). $EDXDEF data set 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 



" TIMER DEFINITION 

a. 

" TIMER ADDRESS=itO 



ADAPTER DEFINITIONS 



SMIOOi* 



MFA58 



ADAPTER TYPE=SMI0,ADDRESS=80, 

DEVICES=($SYSLOG) 
ADAPTER TYPE=MFA,ADDRESS=58, 

DEVICES=($SYSL0GB,MPRTR1,MPRTR2),END=YES 
*ALPAC0 ADAPTER TYPE=ALPA,ADDRESS=CO, 
* DEVICES=(MPRTR3),END=YES 



" VIRTUAL TERMINAL DEFINITIONS 

a. 


"CDRVTA TERMINAL DEVICE=VIRt, 
*CDRVTB TERMINAL DEVICE=VIRT, 

a. 


,ADDRESS=CDRVTB,SYNC=YES 
,ADDRESS=CDRVTA,SYNC=NO 


* SERIES/1 TO SERIES/1 TERMINAL 

A 


DEFINITION 


*S1S1 TERMINAL DEVICE=S1S1, 

JU 


,ADDRESS=25 


* GENERAL PURPOSE INTERFACE BUS 


TERMINAL DEFINITION 


*GPIB TERMINAL DEVICE=GPIB 

■k 


,ADDRESS=25 


" TERMINAL DEFINITIONS 

A _ _ 



*$SYSLOG TERMINAL DEVI CE=^979,ADDRESS=04,HDC0PY=$SYSPRTR,PART=2 
*$SYSL0G TERMINAL OEV I CE=^978,ADDRESS=24 ,HDC0PY=$SYSPRTR,PART=2 
$SYSLOG TERMINAL DEV I CE=A980,ADDRESS=80,HDC0PY=$SYSPRTR ,PART=2, C 

PORT=0,SECADDR=AA,ADAPTER=SMIO 
$SYSLOGA TERMINAL DEV I CE=TTY,ADDRESS=00,CRDELAY=i4,PAGS I ZE=2't , C 

BOTM=23 ,SCREEN=YES ,PART=2 
$SYSLOGB TERMINAL DEV I CE=ACCA,ADDRESS=59 ,M0DE=3101B , C 

ADAPTER=MFA,LM0DE=RS422 ,PART=2 
$SYSPRTR TERMINAL DEV I CE=^97^,ADDRESS=01 
MPRTRl TERMINAL DEV I CE^^tgyS-OIL ,ADDRESS=5A,ADAPTER=MFA, C 

CHARSET=USCA 
MPRTR2 TERMINAL DEV I CE=^975-02L ,ADDRESS=5B ,ADAPTER=MFA, C 

CHARSET=USCA,END=YES 
"REMSUPT TERMINAL DEV I CE=ACCA,ADDRESS=08,B ITRATE=1200, C 

" LM0DE=SWITCHED,ADAPTER=SINGLE,PF1=D886, C 

* C0DTYPE=EBASC,ATTN=D816,PAGSIZE=24,SCREEN=YES 

F^e 7 (Part 2 of 3). $EDXDEF data set 






^kkLOU^ 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 



O 



"MPRTR3 TERMINAL DEV I CE=5219,ADDRESS=C0 ,ADAPTER=ALPA, C 

" PORT=0,SECADDR=00 

*MPRTR3 TERMINAL DEV I CE=522i»,ADDRESS=C0,ADAPTER=ALPA, C 

* PORT=0,SECADDR=00 

"MPRTR3 TERMINAL DEV I CE=5225 ,ADDRESS=CO,ADAPTER=ALPA, C 

" PORT=0,SECADDR=00,END=YES 

JL 

* COMMUNICATION LINE DEFINITION 

J, 

" BSCLINE ADDRESS=09,END=YES 

" SYSTEM COMMON 



$SYSCOM CSECT 




dCB 




QCB 




ECB 




ECB 




ENTRY 


$EDXPTCH 


$EDXPTCH DATA 


128F'0' 


END 





SYSTEM PATCH AREA 
Figure 7 (Part 3 of 3). $EDXDEF data set 

3(d) Edit $EDXDEF 

Use $FSEDIT to add to, modify, or delete from the contents of $EDXDEF to match the set 
of system definition statements you prepared when filling out work sheet 2. For 
information on editing a data set, see $fsedit in the Operator Commands and Utilities 
Reference. 

When editing this data set, be sure that: 

• Continuation indicators in column 72 are not removed. 

• If required, a continuation character is placed in column 72 and the statement is 
continued starting in column 16 of the next line. 

• A system definition statement does not extend beyond column 72. 

After you modify the definition data set to match the system definition statements 
specified the work sheet, you need to save the changes. 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 



3(e) Enter MENU on the COMMAND INPUT One to end the EDIT mode as shown. 



COLUMNS 001 072 
SCROLL ===>HALF 



EDIT --- $EDXDEF,ASMLIB 88 ( 5^*3) 

COMMAND INPUT ===> MENU 

*""*" """"" TOP OF DATA "A*"**""*""""*"""*--""" 

$EDXDEF CSECT 

$ID 
" XPS 

" EVENT DRIVEN EXECUTIVE 

" VERSION 5, MODIFICATION LEVEL 



" THE FOLLOWING DEFINES THE STARTER SUPERVISOR AS SHIPPED ON THE 

" DISKETTE LABELED XS5001. FOR COMPLETE DESCRIPTIONS OF THESE 

" STATEMENTS OR ANY OTHER SYSTEM DEFINITION STATEMENTS, REFER TO 

" THE INSTALLATION AND SYSTEM GENERATION GUIDE, SCB^-OS^^S. 

"" ONLY STATEMENTS WITHOUT AN ASTERISK (") IN COLUMN 1 ARE ASSEMBLED, 



" BASIC STORAGE DEFINITIONS 



"PARTITION NUMBER: 1 2 3 ^ 5 6 7 8 9 10 1 1 12 13 1^ 15 l6 
SYSTEM MAXPROG=(05,05,05,05,05,05,05,05), C 

PARTS=(32,32,32,32,32,32,32,32) 



J 



Press the enter key. $fsedit returns to the primary option menu. 



\J 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 

3(f) Save the changed data set. 



You may want to maintain more than one supervisor. For example, you may need one 
system for development and one for production. It is recommended that you save the 
definition statements that are unique for each supervisor in a separate data set. The 
name assigned to the data set should be named $EDXDEFx, where x is any 
alphanumeric character. 

1 . Enter a 4 on the option line. 

2. Enter the data set name and volume name as shown. 

3. Press the enter key. 

4. Enter a Y in response to the verification prompt and press the enter key. 

^^ 

$FSEDIT PRIMARY OPTION MENU STATUS = MODIFIED 

PRESS PF3 TO EXIT 
OPTION ===> h 

^klk SET NAME =========> $EDXDEFS (CURRENTLY IN WORK FILE) 

VOLUME NAME ==========> EDX002 



WRITE TO $EDXDEFS ON EDX002 (Y/N)? Y 



$FSEDIT saves the contents of the work data set in the data set specified and issues the 
following message: 

I nn LINES WRITTEN TO $EDXDEFS ,EDX002 J 

where nn indicates the number of lines in the data set. 
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Step 3 - Edit Definition Statements to Match Hardware 
Configuration (continued) 

Example: Here is an example of the definition data set as modified for the sample system. 

$EDXDEF CSECT 
$ID 

* XPS 

" EVENT DRIVEN EXECUTIVE 

* VERSION 5, MODIFICATION LEVEL 

" THE FOLLOWING DEFINES THE STARTER SUPERVISOR AS SHIPPED ON THE 

* DISKETTE LABELED XS5001. FOR COMPLETE DESCRIPTIONS OF THESE 

* STATEMENTS OR ANY OTHER SYSTEM DEFINITION STATEMENTS, REFER TO 
" THE INSTALLATION AND SYSTEM GENERATION GUIDE, SC3A-06^6. 

a. 

* ONLY STATEMENTS WITHOUT AN ASTERISK (*) IN COLUMN 1 ARE ASSEMBLED. 

■k 



BASIC STORAGE DEFINITIONS 



SYSTEM MAXPROG=(1,10,10,5,5),PARTS=(0,2^,16,20,32), C 
COMMON=(0,5,0,2,3) 

* BASIC DEFINITION FOR A ^962-1 OR -2 DISK (9.3 MB) 

a. 

D I SK DEV I CE=^962- 1 F ,ADDRESS=03 ,TASK=YES 
" DISKETTE DEFINITIONS 

DISK DEVICE=^96A,ADDRESS=02,TASK=YES,END=YES 

* TERMINAL DEFINITIONS 



\^J 



$SYSPRTR TERMINAL DEV I CE=A973 ,ADDRESS=21 

$SYSLOG TERMINAL DEV I CE=^979 ,ADDRESS=0^,HOCOPY=$SYSPRTR 

$SYSLOGA TERMINAL DEV I CE='4979,ADDRESS=2il,HDCOPY=$SYSPRTR ,END=YES 

" SYSTEM COMMON 

J- 

$SYSCOM CSECT 

■X. 

* NONE DEFINED 



ENTRY $EDXPTCH 

$EDXPTCH DATA 128F'0' SYSTEM PATCH AREA 

END 

Figure 8. Edited $EDXDEFx Data Set 
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Step 4 - Edit Link Control Data Set to Include Software Support 

The link-control data set contains all the supervisor object modules needed to generate an 
operating system. However, the statements for the modules that are not required for the starter 
system are preceded by an asterisk in column one. The asterisk causes the linkage editor to treat 
the statement as a comment rather than a control statement. You must edit the Unk-control data 
set to remove or add asterisks, as appropriate, to match your system requirements. 

The link-control data set is on the volume named asmlib. For the starter system it is named 

$LNKCNTL. 

To edit the link-control data set: 



4(a) Read the link-control data set into the work data set EDITWORK. 

1 . Enter a 3 on the OPTION line. 

2. Enter $LNKCNTL on the data set name Une. 

3. Enter ASMLIB on the VOLUME NAME line. 

4. Press the enter key. 



r 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 3 

DATA SET NAME =========> $LNKCNTL 

VOLUME NAME ==========> ASMLIB 



•-STATUS = 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



L 



$FSEDIT reads the requested data set into the EDITWORK data set and issues the 
following message: 

236 LINES READ FROM SLNKCNTL ,ASML I B 



4(b) Select option 2 (EDIT) to edit $LNKCNTL. Enter a 2 on the OPTION line. 



J 



SFSEDIT PRIMARY OPTION MENU 

OPTION ===> 2 

DATA SET NAME =========> SLNKCNTL 

VOLUME NAME ==========> ASMLIB 



-STATUS = 

PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



A 



Press the enter key. $fsedit displays the $lnkcntl data set. Figure 9 on page IS-90 
shows the contents of SLNKCNTL. 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



STARTER SYSTEM 

EVENT DRIVEN EXECUTIVE 

XPS - VERSION 5, MODIFICATION LEVEL 

COMMENTS MAY BE INCLUDED BY AN '*' IN COLUMN 1 
USE THIS TECHNIQUE TO OMIT UNNEEDED MODULES 



'OPTION NOVERLAY 

' SUPERVISOR SUPPORT 



"25* NO OVERLAY STRUCTURE 

- MUST BE FIRST AND IN PARTITION 1 



PART 1 




VOLUME XS5O02 




^OVLAREA OVLSTART OVLEND 


"23^^ 


INCLUDE EDXSYS 


"1* 


INCLUDE ASM0BJ,EDX002 


*1* 


INCLUDE EDXSVCX 


*1" 


"INCLUDE $DBUGNUC 


^^2" 


INCLUDE EDXALU 


"1" 


INCLUDE EDXSTART 


=^1" 


"INCLUDE SWAITM 


^3. 


^INCLUDE SUPVIO 


"28 



DEFAULT VOLUME FOR INCLUDE MODULES 

USER DEFINED OVERLAY AREA 

SYSTEM TABLES AND WORK AREAS 

OUTPUT FROM USER SYSTEM GENERATION 

TASK SUPERVISOR 

RESIDENT $DEBUG SUPPORT 

EDL INSTRUCTION EMULATOR 

INITIALIZATION S ERROR HANDLER 

WAIT ON MULTIPLE EVENTS 

MAKE SUPERVISOR AND COMMON AREA STATIC 



" TIMER SUPPORT 


- MUST 


BE IN PARTITION 1 


^INCLUDE EDXTIMER 
"INCLUDE E0XTIMR2 

a. 
5V 


*12* 
"12" 


4955 TIMER SUPPORT (78^0) 
4952/i»95^/4956 TIMER SUPPORT 


* EXIO SUPPORT 

J. 


- MUST 


BE IN PARTITION 1 


^INCLUDE lOSEXIO 
"INCLUDE EXIOTRC 

A. 
J- 


"3* 
.3. 


EXIO DEVICE CONTROL SUPPORT 
EXIO TRACE OPTION 


" ERROR LOGGING 


- MUST 


BE IN PARTITION 1 


"INCLUDE CIRCBUFF 

J. 


"16" 


PROGRAM/MACHINE CHECK LOGGING 


" OPTIONAL FUNCTION 

a. 


SUPPORT - 1 


MUST BE IN PARTITION 1 



\J 



INCLUDE RLOADER 

* INCLUDE STORMGR 

* INCLUDE lAMQCB 
INCLUDE PWRAM80 



"17" RELOCATING PROGRAM LOADER 

^^3* UNMAPPED STORAGE MANAGER SUPPORT 

"20* lAM QCB NEEDED FOR lAM SUPPORT 

*26* ^980 POWER ON RAM 



Figure 9 (Part 1 of 5). $LNKCNTL data set contents 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



- HOST 


COMMUNICATIONS 


SUPPORT 


- MUST 


BE IN PARTITION 1 


"INCLUDE 


TPCOM 




"14" 


HOST 


COMMUNICATION 


SUPPORT 


^ TRANSLATION 


TABLES 


- MUST 


BE 


IN 


PARTITION 1 





INCLUDE TRASCI i 
INCLUDE TREBASC 
INCLUDE TREBCD 
INCLUDE TRCRSP 



"10" 1310,2095/2096,7850 ACCA/TTY TRANSLATION 

"10" 1610,2091/2092 ACCA TRANSLATION 

"11" 27^1, PROC EBDC TRANSLATION 

"11" 2741 CORRESPONDENCE TRANSLATION 



EXTENDED ADDRESS MODE - MAY BE INCLUDED IN PARTITION 1 TO 8 
NCLUDE SRMGR "29" INCLUDE FOR EXTENDED ADDRESS MODE SUPPORT 



DISK(ETTE) SUPPORT 



MUST BE GROUPED TOGETHER 

MAY BE INCLUDED IN PARTITION 1 TO 8 



PARTI 

INCLUDE DISKIO 
INCLUDE D49624 
INCLUDE D4963A 
INCLUDE D4966A 
INCLUDE D1024 
-INCLUDE D4969A 



"3" BASIC DISK(ETTE) SUPPORT 
"3" 4962/4964 DISK(ETTE) SUPPORT 
"3" 4963/4967/DDSK-3O DISK SUPPORT 
"3" 4965/4966 DISKETTE SUPPORT 
'3,21" 1024 BYTES/SECTOR DISKETTE SUPPORT 
"3" BASIC TAPE SUPPORT 



TERMINALS 



- MUST BE GROUPED TOGETHER 

- MAY BE INCLUDED IN PARTITION 1 TO 8 



PART 1 






INCLUDE 


EDXTIO 


■ki^-k 


INCLUDE 


MINMSG 


^5>v 


INCLUDE 


FULLMSG 


krk 


INCLUDE 


IOS3IOI 


k^k 


INCLUDE 


I0S4979 


.3. 


INCLUDE 


I0S4974 


.3^ 


INCLUDE 


I0S4975A 


^3. 


INCLUDE 


lOSACCA 


^^V- 


INCLUDE 


ACCATRC 


.3. 


INCLUDE 


lOSTERM 


"A,6" 


INCLUDE 


lOSTTY 


.3. 


INCLUDE 


I0S2741 


^3. 


INCLUDE 


IOS4013 


AnA 


INCLUDE 


lOSGPIB 


.3. 


INCLUDE 


I0SS1S1 


^3^ 


M NCLUDE 


lOSVIRT 


.3^3. 


INCLUDE 


iOSPOOL 


.3. 


MNCLUDE 


EBFLCVT 


"18" 



BASIC TERMINAL SUPPORT 

MINIMUM MESSAGE SUPPORT 

FULL MESSAGE SUPPORT 

ACCA 3IOIB SUPPORT 

4978/4979/4980 DISPLAY SUPPORT 

4973/4974/4975/5219/5224/5225 SUPPORT 

4975-OIA PRINTER SUPPORT 

ACCA DEVICE HANDLER 

ACCA TRACE OPTION 

ACCA/TTY/2741/4013 SUPPORT 

ASR 33/35/3IOI/3IOIC TTY SUPPORT 

2741 TERMINAL SUPPORT 

DIGITAL I/O TERMINAL SUPPORT 

GPIB SUPPORT 

SERlES/1 - SERIES/1 SUPPORT 

VIRTUAL TERMINAL SUPPORT 

SPOOLING SUPPORT 

EBCDIC/FLOATING POINT CONV. 



Figure 9 (Part 2 of 5). $LNKCNTL data set contents 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



' FLOATING POINT - MAY BE INCLUDED IN PARTITION 1 TO 8 

TART 1 

^INCLUDE EDXFLOAT "3" FLOATING POINT ARITHMETIC 



' QUEUE I/O - MAY BE INCLUDED IN PARTITION 1 TO 8 

TART 1 

INCLUDE QUEUEIO "19* QUEUE PROCESSING SUPPORT 



' B I SYNC COMMUNICATIONS - MUST BE GROUPED TOGETHER 

' - MAY BE INCLUDED IN PARTITION 1 TO 8 

TART 1 

'INCLUDE BSCAM "13" BISYNC COMMUNICATION SUPPORT 

-INCLUDE BSCX21 "27" BISYNC COMMUNICATION SUPPORT FOR X.21 



' SENSOR INPUT/OUTPUT - MUST BE GROUPED TOGETHER 

- MAY BE INCLUDED IN PARTITION 1 TO 

TART 1 

INCLUDE SBCOM "15" BASIC SENSOR I/O SUPPORT 

INCLUDE SBAI "3" ANALOG INPUT SUPPORT 

-INCLUDE SBAO "3" ANALOG OUTPUT SUPPORT 

-INCLUDE SBDIDO "3" DIGITAL INPUT/OUTPUT SUPPORT 

-INCLUDE SBPI "3" PROCESS INTERRUPT SUPPORT 



SYSTEM INITIALIZATION - MUST BE IN PARTITION 1 

NCLUDE $PR0G1 "22" USER MODULE INCLUDED IN NUCLEUS GEN 
NCLUDE 10102^ "21" 102^* IPL SUPPORT 



2 SYSTEM SUPPORT -- INITIALIZATION - MUST BE IN PARTITION 
INCLUDE EDXINIT "24" SUPERVISOR INITIALIZATION 



Figure 9 (Part 3 of 5). $LNKCNTL data set contents 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



INSERT USER INITIALIZATION MODULES HERE 



JF«X 



SUPERVISOR CODE BEING MOVED OUT OF 
PARTITION 1 MUST BE MOVED TO HERE 



"PART 2 






"INCLUDE 


SUPVIO 


^^28" 


"PART 3 






"INCLUDE 


SUPVIO 


"28" 


"PART k 






"INCLUDE 


SUPVIO 


"28" 


"PART 5 






"INCLUDE 


SUPVIO 


"28" 


"PART 6 






"INCLUDE 


SUPVIO 


^28" 


"PART 7 






"INCLUDE 


SUPVIO 


=^28" 


"PART 8 






"INCLUDE 


SUPVIO 


"28" 



MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 
MAKE SUPERVISOR AND COMMON AREA STATIC 



LINK $EDXNUCT,EDX002 REPLACE END 



PROGRAMMING NOTES 



ho- 



ir 



MUST BE INCLUDED FIRST AND IN THIS ORDER 
REQUIRED FOR PROGRAM DEBUGGING ($DEBUG) 

OPTIONAL MODULE; REQUIRED IF THE DEVICE OR FEATURE IS USED 
REQUIRED IF ANY TERMINALS ARE INSTALLED, INCLUDING ^973,^974,4975, 
5219, 5224, 5225, 4978, 4979, 4980, GPIB, S/l-S/1, ACCA, TTY, 
2741 , 3101, 4013, ETC. 

MUTUALLY EXCLUSIVE MODULES; ONE, BUT NOT BOTH, IS REQUIRED. 
lOSTERM IS REQUIRED IF lOSTTY, I0S2741 AND/OR IOS4013 ARE INCLUDED, 
lOSTERM MUST ALSO BE INCLUDED WHERE USING N0N-3101B ACCA TERMINALS, 
SEE NOTES 7, 8, 10, 11 . 

I0S3101 IS REQUIRED IF A 3101 TERMINAL IS TO BE USED IN BLOCK MODE 
(DEVICE=ACCA,M0DE=3101B). lOSACCA MUST ALSO BE INCLUDED. 
SEE NOTES 6, 8, 10, 11. 

lOSACCA IS REQUIRED IF DEVICE=ACCA WAS SPECIFIED IN THE SYSGEN. 
APPROPRIATE TRANSLATION TABLE{S) MUST BE INCLUDED. 
SEE NOTES 6, 7, 10, 11. 

REQUIRED IF USING REMOTE MANAGEMENT UTILITY WITH PASSTHRU FUNCTION 
TRASCII AND/OR TREBASC ARE REQUIRED IF AN ACCA OR TTY TYPE ATTACH- 
MENT CARD IS USED. FEATURE CARDS #1310, #2095/2096 AND #7850 
REQUIRE TRASC I I TRANSLATION TABLES. #1610 AND #2091/2092 REQUIRE 
TREBASC TRANSLATION TABLES. 

TREBCD AND/OR TRCRSP ARE REQUIRED IF IOS2741 IS INCLUDED. 2741 
TERMINALS MAY USE EITHER TREBCD OR TRCRSP. 
DEVICE=PROC NORMALLY USES TREBCD. 



Figure 9 (Part 4 of 5). $LNKCNTL data set contents 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



"12" ATTACHED TIMERS (FEATURE 78^*0) AND THE ^952/495^/^956 NATIVE TIMER 

" ARE MUTUALLY EXCLUSIVE. SELECT THE TIMER SUPPORT REQUIRED FOR 

" YOUR CONFIGURATION OR NONE IF NO TIMER SUPPORT IS REQUIRED. 

"13" REQUIRED FOR BINARY SYNCHRONOUS COMMUNICATION USING BSCREAD/ 

" BSCWRITE OR REMOTE MANAGEMENT UTILITY SUPPORT. 

"14" REQUIRED FOR COMMUNICATION TO A S/370 WITH THE EDX HOST 

" COMMUNICATION FACILITY 

"15" REQUIRED IF ANY SENSOR I/O SUPPORT IS TO BE USED 

" (Al ,AO,DI ,D0, OR PI ) 

"16" REQUIRED IF THE IN STORAGE PROGRAM CHECK/MACHINE CHECK LOG 

" IS TO BE KEPT 

"17" REQUIRED IF PROGRAMS ARE TO BE LOADED FROM DISK(ETTE). 

" IF NOT INCLUDED, AN APPLICATION PROGRAM MUST BE LINK EDITED 

" WITH THE SUPERVISOR. 

"18" REQUIRED FOR DATA FORMATTING OPERATIONS (GETEDIT, PUTEDIT, FORMAT) 

"19" REQUIRED FOR QUEUEING OPERATIONS (FIRSTQ, NEXTQ, LASTQ, DEFINEQ) 

"20" ONLY NEEDED IF lAM (5719-AM4) IS EVER TO BE INSTALLED. 

"21" OPTIONAL MODULE; REQUIRED IF THE SYSTEM IS TO BE IPLED 

" FROM A 1024 BYTE/SECTOR DISKETTE. INCLUDE BEFORE EDXINIT. 

"22" USER PROGRAM $PR0G1, LINKED WITH THE SUPERVISOR, MUST 

" PRECEED EDXINIT. THE VOLUME NAME SHOULD REFLECT THE VOLUME 

" WHERE THIS OBJECT MODULE RESIDES. 

"23" OPTIONAL LINK CONTROL STATEMENT TO DEFINE THE OVERLAY AREA 

" DISKBUFR IS EQUATED TO THE START OF SEGINIT, THE START OF THE 

" OVERLAY AREA (IN THIS CASE, OVLSTART) IS EQUATED TO D I SKBUFR+5 12 , 

" AND THE END OF THE OVERLAY AREA IS EQUATED TO THE END OF D I SKI NIT 

" (OVLEND). THE USER MAY DEFINE ANY ENTRIES FOR THE START AND THE 

" END OF THE OVERLAY AREA, BUT THE SIZE MUST BE LARGER THAN THE 

" LARGEST OVERLAY INCLUDED OR USER WILL GET A L I NK ERROR. /^X 

"24" REQUIRED, AND MUST FOLLOW ALL OF THE PREVIOUSLY LISTED MODULES. L J 

" ALL OTHER INITIALIZATION MODULES MUST FOLLOW EDXINIT. AFTER ^'-^ 

" INITIALIZATION IS COMPLETE, ALL STORAGE AFTER EDXINIT IS GIVEN 

" BACK TO THE USER AT THE FIRST PAGE BOUNDARY. 

"25" INCLUDE ONLY IF USER WISHES TO SYSGEN SUPERVISOR IN A NONOVERLAY 

" INITIALIZATION STRUCTURE (OR TAILORED INITIALIZATION STRUCTURE). 

" IF THIS OPTION IS CHOSEN, THEN IT IS THE USER'S RESPONSIBILITY 

" TO INCLUDE MODULES THAT CANNOT BE INCLUDED BY THE PREPROCESSOR 

" (FOR EXAMPLE, RW4963ID, INITMFA, I N I TADAP , INIT4978, INIT4980). 

"26" INCLUDE ONLY IF USER WISHES TO RE-RAM TERMINALS, IN CASE OF 

" POWER ON/OFF, WITHOUT RE- I PL I NG THE SYSTEM. 

"27" REQUIRED FOR X.21 SWITCHED NETWORK SUPPORT WITH BISYNC 

" COMMUNICATION SUPPORT. 

"28" MAKES ALL THE COMMON AND SUPERVISOR AREA OF EACH PARTITION THAT 

" SUPVIO IS INCLUDED IN STATIC (ONLY VALID FOR EXTENDED ADDRESS 

" MODE SUPPORT). 

"29" INCLUDE FOR EXTENDED ADDRESS MODE SUPPORT. IF INCLUDED, RLOADER 

" WILL AUTOMATICALLY BE INCLUDED; EDXTIMR2 WILL ALSO BE INCLUDED 

" AUTOMATICALLY IF EDXTIMER IS NOT INCLUDED. FOR MORE INFORMATION 

" REFER TO THE 'IBM SERIES/] EVENT DRIVEN EXECUTIVE EXTENDED ADDRESS 

" MODE AND PERFORMANCE ANALYZER USER GUIDE', SC34-0591. 

"A" WILL BE INCLUDED AUTOMATICALLY ONLY IF ONE OF THE FOLLOWING IS 

" INCLUDED : lOSTTY, I0S2741 AND/OR IOS4013 

" (SEE NOTE 6 TO DETERMINE IF THE USER MUST INCLUDE THIS MODULE. 

" FOR EXAMPLE, THE CASE WHERE I0S3101 IS REQUIRED IS NOT AUTOMATIC.) 

Figure 9 (Part 5 of 5). $LNKCNTL data set contents 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 

Note: Refer to the EDX Extended Address Mode and Performance Analyzer User Guide, 
SC34-0591, for information about Extended Address Mode support. 

4(c) Edit $LNKCNTL 

Work sheet 3 contains the names of the supervisor object modules you selected to 
provide the software support for the I/O devices attached to your Series/ 1 . Match the 
link control data set to the work sheet, inserting asterisks to omit modules or removing 
asterisks to include the appropriate modules. 

Note: Instead of deleting undesired statements, it is preferable to insert an asterisk in 
column one. The asterisk causes the linkage editor $XPSLINK to treat the statement as a 
comment rather than a control statement. In addition, by not deleting undesired 
statements, you have a record of the support you decided to leave out. This can be 
helpful if problems develop with the generated operating system. 

The number on the PART statement preceding a group of modules specifies the partition 
where the modules are to be located. Some groups of supervisor object modules must 
remain located in partition 1 ; others can be located outside of partition 1 . If you are 
generating a single partition supervisor, you do not have to change the PART statements 
as shown in the link-control data set. If you are generating a multipartition supervisor, 
you should have indicated the number of the partition where you want to locate a 
specific group of modules on work sheet 3. In editing the link-control data to match 
your requirements for a multipartition supervisor, you must physically move any group 
of modules being located outside of partition 1 to the location specified on work sheet 
3 in the $LNKCNTL data set. 

All groups of object modules defined to be in a specific partition must be adjacent to 
one another. For example, you can specify partitions 1, 2, 2, 3, 3, 4, 4 or 1, 2, 2, 4, 3, 
3, 5, 5. You cannot specify partitions 1,1,2, 1,3, 4, 3. This means that if you have 
already defined a group of modules to be in a specific partition and wish to place 
another group of modules in that same partition, you must physically move the second 
group of modules to follow part statement defining that partition. 

If you are going to include your own initialization routines, enter the module names 
following the area specified as INSERT USER INITIALIZATION MODULES HERE If the 
initialization routines are to be treated as overlay segments, be sure each module or 
group of modules is preceded by an overlay statement. In addition, the initialization 
modules must be preceded by a PART statement specifying partition 1 . 

Be sure that the name of the supervisor you are generating is different from the name 
of the current supervisor. 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 

Example: Define a supervisor without default overlay structure, and two groups of object 
modules to be located outside of partition 1 . 



SYSTEM 


SUPPORT — INITIALIZATION 


INCLUDE 


EDXINIT 


-Ik- 


SUPERVISOR INITIALIZATION 


INCLUDE 


RW4963ID 


.3,. 


4963 FIXED HEAD REFRESH SUPPORT 


INCLUDE 


INITMFA 


.3. 


MFA INITIALIZATION 


INCLUDE 


INITADAP 


AoA 


ALPA & SMIO INITIALIZATION 


INCLUDE 


INIT^978 


^3* 


^978 TERMINAL INITIALIZATION 


INCLUDE 


INIT4980 


*3" 


4980 TERMINAL INITIALIZATION 


INSERT 


USER INITIALIZATION 


MODULES HERE 


PART 1 








INCLUDE 


SAMPLE 1 




SAMPLE! INITIALIZATION 


INCLUDE 


SAMPLE2 




SAMPLE2 INITIALIZATION 


INCLUDE 


SAMPLE3 




SAMPLE3 INITIALIZATION 


SUPERVISOR CODE BEING 


MOVED OUT OF 


'■ PARTITION 1 'MUST' BE 


MOVED TO HERE 


'■ SENSOR 


INPUT/OUTPUT - 


MUST 


BE GROUPED TOGETHER 




- 


MAY 1 


BE INCLUDED IN PARTITION 1 to 8 


PART 3 








INCLUDE 


SBCOM 


"15" 


BASIC SENSOR I/O SUPPORT 


INCLUDE 


SBAI 


.3. 


ANALOG INPUT SUPPORT 


INCLUDE 


SBAO 


.3. 


ANALOG OUTPUT SUPPORT 


INCLUDE 


SBIDO 


■k-j-k 


DIGITAL INPUT/OUTPUT SUPPORT 


INCLUDE 


SBPI 


.3. 


PROCESS INTERRUPT SUPPORT 


'• 81 SYNC 


COMMUNICATION 


- MUST BE GROUPED TOGETHER 






- MAY 


BE INCLUDED IN PARTITION 1 to 8 


PART k 








INCLUDE 


BSCAM 


"7" 


BISYNC COMMUNICATION SUPPORT 






Figure 10. Example Edited Link-Control Data Set 

After you modify the link-control data set to match your work sheet, you need to save the 
changes. You may wish to delete the notes at the end of the data set. By deleting the notes, you 
will reduce the time for listing the output generated by $XPSLINK processing. 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 

4(d) Enter MENU on the COMMAND INPUT line and press the enter key to end the EDIT 
mode. 






r 



EDIT --- $LNKGNTL,ASMLIB 
COMMAND INPUT ===> MENU 

*AAAA AAAAA jQp Qp p^jyr^ 



236 ( 5^3)- ——COLUMNS 001 072 

SCROLL ===>HALF 



>v 



EVENT DRIVEN EXECUTIVE - VERSION 5, MODIFICATION LEVEL 






TO INCLUDE A SUPERVISOR OBJECT MODULE IN YOUR OPERATING * 
SYSTEM, LEAVE COLUMN 1 BLANK. TO EXCLUDE A MODULE, * 
PLACE AN '"' IN COLUMN 1. * 



5yE!l5yi59L!!;l???5La.x^a.^. 






INCLUDE EDXSYS,XS5002 "l" SYSTEM TABLES AND WORK AREA 

$FSEDIT returns to the primary command menu. 

4(e) Select option 4 (WRITE) to save the changes made to the link-control data set. 

You may want to maintain more than one supervisor. For example, you may need one 
system for development and one for production. It is recommended that you save the 
Unk-control data set that is unique for each supervisor in a separate data set. The name 
assigned to the data set should be named LINKCTLx, where x is any alphanumeric 
character. 

1. Enter a 4 on the OPTION line 

2. Enter name of the data set where you want to save the new link-control data set. 
(linkcntl in the example.) 

3. Enter the name of the volume containing the data set. (EDX002 in the example.) 

4. Press the enter key. 

5. Enter a Y in response to the verification prompt. 

6. Press the enter key. 
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Step 4 - Edit Link Control Data Set to Include Software Support (continued) 



V 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> k 

DATA SET NAME =========> L I NKCNTL 

VOLUME NAME ==========> EDX002 



WRITE TO LINKCNTL ON EDX002 (Y/N)? Y 

$FSEDIT issues the following message: 
nn LINES WRITTEN TO L I NKCNTL ,EDX002 



■STATUS = MODIFIED 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



J 



where nn indicates the number of lines in the data set. 

Example: The following is an example of the linkcntl data set for the sample system. Only 
the modules without an asterisk in column one are included in the supervisor. 

"OPTION NOVERLAY "25" NO OVERLAY STRUCTURE 

" SUPERVISOR SUPPORT - MUST BE FIRST AND IN PARTITION 1 



PART 1 

VOLUME XS5O02 
'OVLAREA OVLSTART OVLEND "23 

INCLUDE EDXSYS 

INCLUDE ASM0BJ,EDX002 

INCLUDE EDXSVCX 

INCLUDE EDXALU 

INCLUDE EDXSTART 
'INCLUDE SWAITM "3 



DEFAULT VOLUME FOR INCLUDE MODULES 
USER DEFINED OVERLAY AREA 
SYSTEM TABLES AND WORK AREAS 
OUTPUT FROM USER SYSTEM GENERATION 
TASK SUPERVISOR 
EDL INSTRUCTION EMULATOR 
INITIALIZATION S ERROR HANDLER 
WAIT ON MULTIPLE EVENTS 



OPTIONAL FUNCTION 


SUPPORT - 


MUST 


BE IN 


PARTITION 


1 






INCLUDE RLOADER 


"17" 


RELOCATING 


PROGRAM i 


-OADER 




DISK(ETTE) SUPPORT 


- MUST 


BE 


GROUPED 


TOGETHER 


IN 


ANY 


PARTITION 



Figure 11 (Part 1 of 2). LINKCNTL Data Set for the Sample System 
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Step 4 - Edit Link Control Data Set to Include Software Support {continued) 



PART 1 

INCLUDE DISKIO 

INCLUDE D49624 


"3" BASIC DISKCETTE) SUPPORT 
"3* k3ii2/k%k DISKCETTE) SUPPORT 


SYSTEM INITIALIZATION 


- MUST BE IN PARTITION 1 


INCLUDE EDXINIT 


"24" SUPERVISOR INITIALIZATION 


SUPERVISOR CODE BEING 
PARTITION 1 "must" BE 


MOVED OUT OF 
MOVED TO HERE 




' TERMINALS 


- MUST BE GROUPED TOGETHER IN ANY PARTITION 



PART 8 

INCLUDE EDXTIO "^l" BASIC TERMINAL SUPPORT 

INCLUDE FULLMSG "5" FULL MESSAGE SUPPORT 

INCLUDE I0S4979 "3" ^+978/4979 DISPLAY SUPPORT 

JNCLUDE I0S4974 "3" 4973/^974/4975 PRINTER SUPPORT 

LINK $EDXNUC2,EDX002 REPLACE END 



Figure 1 1 (Part 2 of 2). LINKCNTL Data Set for the Sample System 



^i^iyul,^ 



Step 5 - Edit $JOBUTIL Procedure File 



You are now ready to assemble the system definition statements and link edit the resulting 
object module with the supervisor support object modules specified in the edited link-control 
data set. 

The assemble and link edit steps are performed under control of the job stream processing utility 
$JOBUTiL. You could load the assembler $EDXASM, provide the data set names required, and do 
the assembly. Then you could do the same for $XPSLINK. But, by using $JOBUTlL, the two steps 
can be accomphshed with a single entry. 

You control the $JOBUTlL operation with a series of job control statements. For system 
generation, a data set called $SUPPREP is supplied on volume ASMLIB. 

If you did not change the recommended names for the data sets (EDITWORK, ASMWORK, ASMOBJ, 
and linkwork) in step 2 and used the names $edxdefs and $linkcntl for the definition data 
set and link-control data set in steps 3 and 4, you do not need to edit $SUPPREP as described in 
steps 5(b) and 5(c). However, we recommend saving the $SUPPREP data set to a data set called 
SUPPREPS on volume EDX002 for future system generations as described in steps 5(a), 5(d), and 
5(e). Once you copy $SUPPREP to SUPPREPS on EDX002, proceed to step 6. 
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Step 5 - Edit $JOBUTIL Procedure File (continued) 



For example, if you called the assembler work data set ASMOBJl instead of ASMOBJ and 
increased its size, you would have to change the name and record size in statement 140 and the 
name in DS statement 220. See Figure 12 on page IS- 101 which shows the $SUPPREP data set. 

To edit $supprep: 

5(a) Read the $SUPPREP data set into the work data set. 

1 . Enter a 3 on the option line 

2. Enter $SUPPREP on the DATA set name line. 

3. Enter ASMLIB on the VOLUME NAME line. 

4. Press the enter key. 

If you do not need to edit $supprep, skip to step 5(d). 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===>3 

DATA SET NAME =========> $SUPPREP 

VOLUME NAME ==========> ASML IB 



-STATUS = 

PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



A 






L 



$FSEDIT reads the requested data set into the EDITWORK data set and issues the 
following message: 

32 LINES READ FROM $SUPPREP ,ASML I B 



J 



5(b) Select option 2 (EDIT) to edit $SUPPREP. 

1 . Enter a 2 on the option line 

2. Enter $SUPPREP on the DATA SET NAME line. 

3. Enter ASMLIB on the VOLUME NAME line. 

4. Press the enter key. 
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Step 5 - Edit $JOBUTIL Procedure File (continued) 



r 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 2 

DATA SET NAME =========> $SUPPREP 

VOLUME NAME ==========> ASML I B 



•-STATUS = 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE! 



$FSEDIT displays the $supprep data set. 






EDIT --- $SUPPREP,ASMLIB 

COMMAND INPUT ===> 

""""" """"" TOP OF DATA ' 

00010 " 

00020 " 

00030 " 

00040 " 

00050 LOG 

00060 JOB 

00070 REMARK 

00080 REMARK 

00090 PAUSE 

00100 " 

00110 DE 

00120 AL 

00130 DE 

001^0 AL 

00150 DE 

00160 AL 

00170 PROGRAM 

00180 NOMSG 

00190 PARM 

00200 DS 

00210 DS 

00220 DS 

00230 EXEC 

00240 JUMP 

00250 PROGRAM 

00260 NOMSG 

00270 PARM 

00280 DS 

00290 DS 

00300 EXEC 

00310 LABEL 

00320 EOJ 



30 ( 543)- 



■COLUMNS 
SCROLL = 



001 072 

==>HALF 



EVENT DRIVEN EXECUTIVE 
VERSION 5, MODIFICATION LEVEL 



-GO- AFTER -XS50O2- HAS BEEN VARIED ONLINE 



$SYSPRTR 
$SUPPREP 
"" ENTER 
"" EXECUTION PRODUCES $EDXNUCT ON EDX002 "" 

DELETE WORK DATA SETS AND REALLOCATE (OR ALLOCATE) 

ASMW0RK,EDX002 

ASMW0RK,EDX002 500 D 

ASM0BJ,EDX002 

ASM0BJ,EDX002 300 D 

LINKW0RK,EDX002 

LINKWORK,EDX002 600 D 

$EDXASM,ASMLIB 

OVERLAY k EN 
$EDXDEFS,EDX002 
ASMW0RK,EDX002 
ASM0BJ,EDX002 

ENDJ0B,NE,-1 
$XPSLINK,EDX002 

$SYSPRTR YES 

LINKW0RK,EDX002 

LINKCNTL,EDX002 

ENDJOB 
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Step 5 - Edit $JOBUTIL Procedure File (continued) 

5(c) Change the data set names and sizes where appropriate. You must change one or more 
of the following names: 

ASMWORK 

LINKWORK 

ASMWORK 

ASMOBJ 

$EDXDEFS 

LINKCNTL. 

Some of these names appear on more than one line. 

5(d) Enter MENU in the COMMAND INPUT line to end the EDIT mode and press the enter 
key. 



o 



30 { 5^3)- 



COLUMNS 001 072 



A 



EDIT --- $SUPPREP,ASML1B 

COMMAND INPUT ===> MENU 

^*""" """"" TOP OF DATA """ 

00010 " 

00020 " EVENT DRIVEN EXECUTIVE - VERSION 5, MODIFICATION LEVEL 



$FSEDIT returns to the primary option menu. 

5(e) Select option 4 (WRITE) to save the changes made to $SUPPREP. 

1 . Enter a 4 on the OPTION Une. 

2. Enter the new data set name, SUPPREPS on the DATA SET NAME line. 

Assign a unique name to this data set, if you have more than one supervisor and 
want to keep the $J0BUTIL data set for each. Name the data set SUPPREPx, where 
X is any alphanumeric character. 
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Step 5 - Edit $JOBUTIL Procedure File (continued) 



3. Enter the volume name, EDX002 on the VOLUME name Une. 

4. Press the enter key. 



r 



I 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> k 

dkJIK SET NAME =========> SUPPREPS 

VOLUME NAME ==========> EDX002 

WRITE TO SUPPREPS ON EDX002 (Y/N)? Y 



$FSEDIT issues the following message, 

where nn indicates the number of lines in the data set: 

nn LINES WRITTEN TO SUPPREPS, EDX002 



STATUS = MODIFIED 
PRESS PF3 TO EXIT 



(CURRENTLY I N WORK FILE) 



r 



$FSEDIT PRIMARY OPTION MENU 

OPTION ===> 8 

DATA SET NAME =========> SUPPREPS 

VOLUME NAME ==========> EDX002 



STATUS = MODIFIED 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK FILE) 



A 



5(f) Select option 8 (END) and press the enter key to end the $FSEDIT utility. 



J 



A 



L 



$FSEDIT responds as follows: 

$FSEDIT ENDED 



J 
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Step 6 - Execute $SUPPREP 



To create a tailored supervisor, you must first assemble your system configuration statements in 
$EDXDEFS. Then you need to link edit the supervisor object modules in the link-control data set 
($LNKCNTL) and convert the results to an executable program using $xpslink. $xpslink is a link 
editor set up for generating operating systems. There are two ways to run $XPSLINK and the 
procedure in suppreps. You can use either the session manager option 2.8 or 2.13 or the 
$JOBUTlL job stream processor. 

To use the session manager, you must have installed the program preparation modules 
(5719-XX6). For general information on how to use the session manager, see the Operation 
Guide. 

The procedure described here uses the $jobutil job stream processor to execute the procedure 
in SUPPREPS. 



6(d) Press the attention key, enter $L $JOBUTIL and press the enter key. 



> $L $JOBUTIL 

DSl (NAME, VOLUME): SUPPREPS ,EDX002 

LOADING $JOBUTIL 4P, 00: 51: 57, LP= 9200, PART= 1 
REMARK "" ENTER -GO- AFTER -XS5002- HAS BEEN VARIED ONLINE 
REMARK "" PRODUCES $EDXNUCT ON EDX002 "" 

PAUSE---ATTN: GO/ENTER/ABORT 

PAUSE 



A 



6(b) Insert diskette XS5002 into your diskette unit. 

Diskette XS5002 contains the supervisor object modules which are accessed only 
during the system generation process. 

Note: If you are using a 4966 Diskette Magazine Unit, insert the diskette in slot 1 and 
vary the diskette online. To do this: 

• Press the attention key 

• Press the enter key 

• Enter $VARYON nn,l, where nn is the hexadecimal address of the 4966 Diskette 
Magazine Unit. 



> $VARYON 22,1 
XS5002 ONLINE ON SLOT 1 
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Step 6 - Execute $SUPPREP (continued) 



6(c) Press the attention key and enter GO in response to the PAUSE prompt. 



> GO 



*^ 



$JOBUTIL ENDED 






^ 



The procedure file has $SYSPRTR specified as the log device. The first thing that happens is that 
the procedure file statements controlling the assembly operation print out on the $SYSPRTR. 
$JOBUTlL then loads the compiler, $EDXASM, which assembles your system definition source file, 

$EDXDEFS. 

The resulting object module is stored in data set asmobj on volume EDX002, which you created. 
The Usting produced as a result of the assembly prints out on the $SYSPRTR, preceded by 
assembler statistics. 

Next, $JOBUTlL loads the hnkage editor, $XPSLINK. $XPSLINK is a special linkage editor set up to 
generate operating systems. It loads three programs, in the following order: $xpspre, 
$EDXLINK, and $XPSPOST. Each of these programs performs its function as follows: 

$XPSPRE: $xpspre scans the link-control data set for supervisor object modules to be 
located outside of partition 1. When it finds such a module, it builds separate link-control 
statements for each supervisor partition specified by the PART statement in the LINKCNTL data 
set. In addition, $XPSPRE includes a 'root' module in partition 1 that corresponds to the 
supervisor object module being located outside of partition 1 . The 'root' segment provides the 
connection between the supervisor object module and the system control blocks located in 
partition 1. 

The listing of the LINKCNTL data set produced as a result of processing $XPSPRE prints on the 
$SYSPRTR or the terminal you specify. A completion code of -1 indicates success. 

$EDXUNK: Using the object module from the assembly (asmobj) and the link-control 
statements stored in LINKCNTL, the $EDXLINK program link edits each group of Unk-control 
statements created by $xpspre with the system control blocks generated by the assembly 
(asmobj object modules). $edxlink creates separate output data sets for each group of 
modules specified with a PART statement. These data sets are called XPSSEGlx through 
XPSSEGSx where x is the last character of the name of the nucleus specified on the LINK 
statement. 

$EDXLINK prints out each data set and any unresolved references resulting from the link edit on 
the $SYSPRTR or the terminal you specify. There will be several unresolved weak external 
references (wxtrn) for supervisor support modules you did not want to include, but no 
unresolved extrn messages should appear. Following the extrn messages, it Usts whether or 
not the data set containing the supervisor modules was stored, the size (in records) of the data 
set, and a completion code. 
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Step 6 - Execute $SUPPREP (continued) 



In addition, it prints out the modules you included, the modules $xpslink automatically 
included, and the names of the root segments for each partition. At the end of this list is a total 
for the LNTH column. This figure is the size of the supervisor within that partition. 

$XPSPOST: After $edxlink Unk edits the data sets that make up the supervisor, $xpslink 
calls $XPSPOST. $XPSPOST merges the entry point addresses for the supervisor object modules 
together to form a table in partition 1 . This table resides in partition 1 and contains the 
locations of all the supervisor modules in the system. $xpspost also relocates the addresses of 
the supervisor modules outside partition 1 to allow them to be loaded at IPL time. 

The formatted load module is placed in $EDXNUCx, a supervisor data set allocated 
automatically by $XPSLINK. $XPSLINK ends and $JOBUTlL completes. 

When $JOBUTlL completes, examine the output printed on $SYSPRTR for errors. Errors are 
usually caused by incorrect editing of $EDXDEF, $LNKCNTL or $SUPPREP. If errors are found, 
examine your system definition statements and link edit control statements. Then correct 
$EDXDEFS, LINKCNTL, or SUPPREPS as necessary using the $FSEDIT utility. 

Notes: 

1. If you receive undefined label messages, you may have forgotten the continuation character 
in column 72. 

2. Unresolved WXTRN messages resulting from the execution of $XPSLINK can occur. A WXTRN ^~^ 
message lists modules that may or may not be required in your supervisor. Your supervisor L J 
is generated with or without these modules. Examine the message to determine whether the ^'^"^ 
referenced names refer to the modules that you require in your operating system. 

3. An unresolved WXTRN of $PROGl normally occurs unless you Unk edit an application 
program with the supervisor, as described under step 3 in Chapter 4, "Select Your Required 
Support" on page IS-39. 

4. Unresolved extrn messages should not occur if a valid operating system has been 
generated. An extrn message lists modules that MUST be included in your supervisor. A 
complete listing of all supervisor module names and entry points is included in Appendix 
D, "Supervisor Module Names (CSECTS)" on page IS-275. If you have not included the 
module listed, edit LINKCNTL to include the missing module. 
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Step 6 - Execute $SUPPREP (continued) 



5. Your supervisor may have exceeded 64K within a specific partition. If it does, the following 
message is printed following link-control statements: 



XPSSEGIx, volume NOT STORED 
COMPLETION CODE = 12 



The total of the LNTH column following the list of modules included in the supervisor 
contains the amount by which the 64K was exceeded. You must reduce the size of the 
supervisor by at least this amount. For information on making your supervisor smaller, see 
"Reducing the Size of Your Supervisor" on page IS-68. 

After you correct the errors, execute $XPSLINK again through the $JOBUTiL procedure or the 
session manager option 2.8. 

You should save the system definition statements ($EDXDEFS), the link-control statements 
(linkcntl), and the listings printed as a result of the system generation process. They provide 
you with a record which can be helpful if problems develop with the generated operating system. 






Step 7 - Using the Generated Operating System 



Before you can use the new operating system, it must be designated as the one to be loaded at 
IPL time. To do this, you must load $INITDSK and initialize $EDXNUCx as the new operating 
system. In response to the NUCLEUS prompt, enter the name of your supervisor as specified on 
the LINK statement in the linkcntl data set. If you enter a supervisor name that does not exist, 
$INITDSK issues the following message and ends the ii command. 



L 



NVALID NUCLEUS NAME 



$INITDSK issues the COMMAND (?): prompt again. Enter the il command again and reenter the 
name of your supervisor. 

In this example, the name of the supervisor is $EDXNUC2 on EDX002. 
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Step 7 - Using the Generated Operating System (continued) 



7(a) Press the attention key and load the $INITDSK utility. Respond to the $INITDSK 

prompts as shown. 



r 



> $L $INITDSK 
LOADING $INITDSK 98P, LP' 9200, PART= 1 

$INITOSK - DISK INITIALIZATION UTILITY 

COMMAND (?): II 
NUCLEUS: $EDXNUC2 
VOLUME: EDX002 
I PL TEXT WRITTEN 

COMMAND (?):EN 

$INITDSK ENDED AT 01:05:16 



A 



Now you can use $EDXNUCx as your supervisor. 

7(b/ Press the LOAD button on the Series/ 1 console and IPL the new supervisor. 

If the new operating system fails to operate correctly, you must restore the starter 
system by IPLing from diskette XS5001. Then use the II command to redirect the IPL 
text to point to the operating system that you specify (in this case, $EDXNUC2 on 
EDX002). Repeat steps 2 through 5 to correct any errors. 

If the IPL is successful, the ipl message is displayed. Following is the IPL message for 
the sample system: 



*'- EVENT DRIVEN EXECUTIVE 
""" XPS 



" V5.0 



IPL=$EDXNUC2,EDX002 

XPS SYSTEM STORAGE MAP 



USER 

PART START 

# (DEC) 



1 22272 

2 4096 

3 
ii 2048 
5 2048 
8 11264 

TOTAL (HEX): 
UNMAPPED STORAGE = 



USER 
SIZE 
(DEC) 
14592 
49152 
32768 
40960 
63488 
1024 



COMMON SUPV 
SIZE START 
(HEX) (HEX) 




1000 


0800 
0800 






1000 


0800 
0800 





137 (DEC) 2K 



SUPV USER 

SIZE START 

(HEX) (HEX) 

5700 5700 

1000 



0800 

0800 

2C00 2C00 
8300 
BLOCKS 



USER 

SIZE 

(HEX) 
3900 
COOO 
8000 
AOOO 
F800 
0400 

31500 



TOTAL 

SIZE 

(HEX) 

9000 

DOOO 

8000 

A8OO 

10000 

3000 






IS- 108 SC34-0646 






Step 7 - Using the Generated Operating System (continued) 



The IPL message contains 9 columns. An explanation of each column follows. 

PART # Part # indicates the the number of the partition. 

USER START The starting address (in decimal) of the first program loaded for 
execution within each partition. 

USER SIZE The amount of storage (in decimal) within each partition available 

for program execution. 

COMMON SIZE The size (in hexadecimal) of the common area within each partition. 

SUPV START The starting address (in hexadecimal) of the supervisor within each 
partition. 

SUPV SIZE The size (in hexadecimal) of the supervisor within in each partition. 

USER START The starting address (in hexadecimal) of the first program loaded 
for execution within each partition. 

USER SIZE The amount of storage (in hexadecimal) within each partition 

available for program execution. 

TOTAL SIZE The total size (in hexadecimal) of each partition. 

You may now execute programs under the tailored operating system. Load and execute 
utility programs that exercise the various supervisor components (such as disk I/O, 
sensor I/O, and so forth). 

If you want your supervisor named by the standard nucleus name ($EDXNUC), follow 
steps 6(c) and 6(d), thereby always having $EDXNUC as your current supervisor. If you 
want to maintain multiple supervisors, leave your supervisor named $EDXNUCx where 
X is a unique alphanumeric character and proceed to step 8. 

Note: For information on maintaining more than one supervisor, see "Maintaining 
Multiple Supervisors" on page IS-1 13. 



Chapter 5. Generate a Tailored Operating System IS- 1 09 



Generate a Tailored Operating System 



Step 7 - Using the Generated Operating System (continued) 

7(c) Press the attention key and load the $COPYUTl utility. Respond to the $COPYUTl 
prompts as shown. 



r 



> $L $C0PYUT1 
LOADING $C0PYUT1 



$C0PYUT1 



59P, LP= 9200, PART= 1 
DATA SET COPY UTILITY 



MEMBERS ON TARGET VOLUME WILL BE DELETED 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE 

THE DEFINED SOURCE VOLUME IS EDX002, OK (Y/N)? Y 
THE DEFINED TARGET VOLUME IS EDX002, OK (Y/N)? Y 
MEMBER WILL BE COPIED FROM EDX002 TO EDX002 OK (Y/N)? Y 

COMMAND (?): CM 

ENTER FROM(SOURCE) MEMBER: $EDXNUC2 

ENTER TO (TARGET) MEMBER OR * FOR SAME NAME AS SOURCE: $EDXNUC 

COPY COMPLETE 257 RECORDS COPIED 

COMMAND (?): EN 

$C0PYUT1 ENDED AT 00:26:07 



8(d) Press the attention key and load $INITDSK. Respond to the $INITDSK prompts as 
shown. 



> $L $INITDSK 
LOADING $INITDSK 



,r' 



A 



$INITDSK 



98P, LP= 9200, PART= 1 
DISK INITIALIZATION UTILITY 



^ 



COMMAND (?): II 
NUCLEUS: $EDXNUC 
VOLUME: EDX002 

COMMAND (?): EN 

$IN1TDSK ENDED AT 01:05:16 



The II command initializes the new supervisor (in this case, $EDXNUC2 on EDX002) so 
you'll always have $EDXNUC as your current supervisor. 



\^ 
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Step 8 - Verify the System Generation Process (Optional) 



To verify that system generation has performed correctly, assemble and execute the sample 
program CALCSRC on EDX002. 



■> 



o(a) Press the attention key, load the $EDXASM compiler, and provide the parameters 
necessary to assemble CALCSRC, as follows: 



r 



> $L $EDXASM,ASMLtB CALCSRC ASMWORK ASMOBJ 
LOADING $EDXASM 78P, LP= 9100, PART=1 

SELECT OPTIONS (?): NOLIST END 
ASSEMBLY STARTED 

1 OVERLAY AREA ACTIVE 
EDX ASSEMBLER STATISTICS 

SOURCE INPUT - CALCSRC, EDX002 
WORK DATA SET - ASMWORK, EDX002 
OBJECT MODULE - ASMOBJ, EDX002 
STATEMENTS PROCESSED - 66 



NO STATEMENTS FLAGGED 
EXTERNAL/UNDEFINED SYMBOLS 



SVC 


WXTRN 


SUPEXIT 


WXTRN 


SETBUSY 


WXTRN 


COMPLETION CODE = 


-1 


$EDXASM ENDED 





^ 






If you assemble CALCDEMO successfully (completion code = -1), continue. If you 
receive a completion code other -1, see the Messages and Codes book for its meaning, 
correct the problem, and reassemble calcdemo. 
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Step 8 - Verify the System Generation Process (Optional) (continued) 



o(b) Press the attention key, load $EDXLINK and provide the parameters necessary to link 
edit CALCSRC. This step produces a listing on the printer designated as $SYSPRTR. 

Note: If you have created calcdemo previously, respond with LINK CALCDEMO REP 
END to the second STMT(?): prompt. 

■ \ 

> $L $EDXLINK 

L I NKWORK( NAME .VOLUME ) : LI NKWORK ,EOX002 
LOADING $EDXLINK 91P. LP= 9100, PART=1 
$EDXLINK - EOX LINKAGE EDITOR 

PARM(?): * 

$EDXLINK INTERACTIVE MODE 

DEFAULT VOLUME - EDX002 

STMT(?): INCLUDE ASMOBJ 

STMT(?): LINK CALCDEMO END 

$EDXLINK EXECUTION STARTED 

CALCDEMO, EDX002 STORED 
PROGRAM DATA SET SIZE = ^ RECORDS 
COMPLETION CODE = -1 
. $EDXLINK ENDED 

If you receive a completion code of -1, continue. If you receive a completion code 
other than -1, see the $EDXLINK completion codes in Messages and Codes for an 
explanation of the code received. Correct the error and relink CALSRC. 



o 



o(c) Press the attention key and load the verification program, CALCDEMO. Follow its 

operating instructions until you decide to end the program. When you decide to end 
the program, enter 'STOP'. 



r 



$L CALCDEMO 
CALCDEMO 3P, LP= 9100, PART=1 
PRESS 'ATTENTION' AND ENTER 'CALC' OR 'STOP' 

> CALC 



A = 30 
B = 6 

A + B = 
A - B = 
A " B = 
A / B = 

PRESS 'ATTENTION 
> STOP 
CALCDEMO ENDED 



A 



36 

Ik 

180 

5 REMAINDER = 
AND ENTER 'CALC' OR 'STOP 



Successful program execution indicates that your operating system is also executing correctly. 
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Step 8 - Verify the System Generation Process (Optional) (continued) 

Use the LS of the $iotest utility to Ust the I/O devices supported by the generated supervisor. 
With this Ust, you can verify that the supervisor does indeed support all the devices you intended 
it to support. 



Maintaining Multiple Supervisors 

You may want to maintain more than one supervisor. For example, you may need one system 
for development and one for production. The II command (initialize IPL text) of the SINITDSK 
utility allows you to use any supervisor on any disk(ette) volume. The II command initializes the 
supervisor that you specify. 

We recommend that you keep your supervisor programs on the IPL volume EDX002. When your 
supervisor resides on a volume other than EDX002, it searches that volume for the system 
utilities. However, the system utilities reside on volume EDX002. Each time you access the 
system utilities, you will need to indicate the volume they reside on; in this case, EDX002. 

The following example points the IPL text to $EDXNUC2 on volume EDX002. 

COMMAND (?): I 1 
NUCLEUS: $EDXNUC2 
VOLUME: EDX002 
IPL TEXT WRITTEN 

V ^ 

The supervisor you are using must be named $EDXNUCX, where x is any alphanumeric character. 



Generating an Operating System for a Diskless System 



For Series/ 1 systems that do not have a fixed disk or the Program Preparation FaciUty, 
generating an operating system requires the following steps: 

1 . Compile and link edit the supervisor for the target Series/ 1 on a system that supports 
program preparation. 

2. Compile the application programs for the target Series/ 1 . 

3. Use the $INITDSK utility to initialize one or more diskettes with program space for the 
supervisor program, utiUties, additional products and application programs. 

4. Transfer the supervisor to $EDXNUC on the IPL volume of the diskette with the $COPYUTl 
utility. Use $INITDSK to write ipl text for $edxnuc on the diskette. 
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Generating an Operating System for a Diskless System (continued) 

5. Along with your application programs, copy the following support modules and utilities onto 
the IPL volume with the $COPYUTi utility: 

Support modules $LOADER, $4978CS0, $4978180, $4980CS0, $4980180, $MFARAM, SACCARAM, 
$FPCARAM, $RAM8EC, SSMIORl 

Utaities $DISKUT1 , $DI8KUT2, SCOPYUTl , $DA8DI, $INITDSK, $TERMUT1 , $TERMUT2, 

$TERMUT3, $IOTE8T 

Notes: 

a. If you are going to support 1024 byte/sector diskettes copy $101024. 

b. If you copy $diskut2, then copy $logutoo. 

c. If you copy $DASDI, then copy $IDSKETT. 

d. If you copy $image, then use SCOPYUTI and copy generic (CG) for $IM. 

e. If you copy $F8EDIT, then use $COPYUTi and copy generic (CG) for $F8. 

f. For specific application programs, you may need modules. Refer to the appropriate 
program directories for these requirements. 

g. For Pascal applications, the diskette must be initialized as a multivolume type if the 
Pascal runtime error messages are desired. The PCSM8G data set resides on the volume 

PASCAL. 

h. If you copy $TERMUT1, then use COPYUTl and copy generic (CG) for $term. 

6. Install the diskette(s) on the target machine for execution. 

For each unique Series/ 1 supervisor that you create, save the associated system definition 
statements ($edxdefx), the link-control statements (linkcntl) with different names, and the 
Usting printed as a result of the system generation process. They provide you with a record 
which can be helpful if problems develop with the generated operating system. 



Multifunction Attachment Random Access Memory 

The random access memory module for the Multifunction Attachment (mfa) Feature #1310 is 
provided with the Event Driven System (edx) and with a Program Temporary Fix (ptf), if 
necessary. The module $mfaram on volume EDX002 is a 45 record data set containing three 
15-record random access memory load modules, one for each engineering level of the MFA card. 
EDX loads the appropriate module when you IPL your system. 
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Multifunction Attachment Random Access Memory (continued) 

If the microprocessor within the mfa is changed because of an engineering change, an updated 
random access memory module ($$edxlib,mfa) is included on the Customer Service 
Representative's initializer diskette. Use the $COPY utility to copy the 15 -record module 
($$edxlib,mfa) to one of the three 15 -record segments of $mfaram on EDX002 as determined 
by the engineering level of the mfa card. 

To copy the mfa initializer diskette: 

1 . Insert the initializer diskette (volume mfa) into the diskette unit and close the door. 

2. Use the $varyon command to vary the initializer diskette (volume MFA) online. 

3. IPL your system. 

4. Load the $copy utility and use the CD command to copy the updated module from the 
initializer diskette to the appropriate 15 records of $MFARAM on EDX002. 

The following examples show using $COPY (CD command) to copy the initializer diskette. 
Respond as shown when copying the diskette. 

Example 1 : Copy the first 15 records to $mfaram,edxoo2. 



> $L $COPY 
LOADING $COPY 



$COPY 



kh?, LP=7E00, PART=1 
COPY UTILITY 



COMMAND (?): CD $$EDXLIB,MFA 

FIRST RECORD: 1 

LAST RECORD: 15 

TARGET(NAME, VOLUME): $MFARAM,EDX002 

FIRST RECORD: 1 

ARE ALL PARAMETERS CORRECT (Y/N)? Y 

COPY COMPLETE 

15 RECORDS COPIED 

COMMAND {?): 
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Multifunction Attachment Random Access Memory (continued) 



Example 2: Copy the second 15 records to $mfaram,edX002. 

> $L $COPY 

LOADING $COPY 46P, LP=7E00, PART=1 

$COPY - COPY UTILITY 

COMMAND (?): CD $$EDXLIB,MFA 

FIRST RECORD: 1 

LAST RECORD: 15 

TARGET( NAME, VOLUME): $MFARAM,EDX002 

FIRST RECORD: 16 

ARE ALL PARAMETERS CORRECT (Y/N)? Y 

COPY COMPLETE 

15 RECORDS COPIED 

COMMAND {?): 



Example 3: Copy the third 15 records to $mfaram,edx002. 



> $L $COPY 
LOADING $COPY 



it6P, LP=7E00, PART=1 



$C0PY - COPY UTILITY 

COMMAND (?): CD $$EDXLiB,MFA 

FIRST RECORD: 1 

LAST RECORD: 15 

TARGET( NAME, VOLUME): $MFARAM,EDX002 

FIRST RECORD: 31 

ARE ALL PARAMETERS CORRECT (Y/N)? Y 

COPY COMPLETE 

15 RECORDS COPIED 

COMMAND (?): 






^6...^ 
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This chapter describes what you must do to convert from Version 1 or 2 to Version 5. Both 
programs and data must be converted before Version 5 can become operational. 






Conversion of Programs 



Before you can use EDX Version 5, you must recompile or reassemble all EDX Version 1 or 2 
programs. The source code must be modified if the Version 5 function is to be utilized or if the 
program references system control blocks. 

In Version 5, the parameter area contained in the program header (defined by the PARM= 
operand of the PROGRAM statement) is smaller than the Version 2 parameter area. In Version 5 
it is 980 bytes, less 66 bytes for each data set name or overlay name specified on the PROGRAM 
statement. 

If an EDL program was used with 4978 or 4979 Display Terminals and will now be used with 
3101 Display Terminals, then you should read the Version 5 Language Reference if you wish to 
make coding changes to the program. 
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Conversion of Programs {continued} 

Conversion Requirements 

The program conversion requirements are as follows: 

• FORTRAN, COBOL, and PL/I applications: 

Compile the applications using the current compiler level forEDX Version 5; link edit with 
the appUcation. After the data conversion is completed, the appUcation is ready for 
execution. Data sets in the new format can be accessed in either sequential or direct mode. 

• EDL and assembler language applications: 

Source code changes are required if the application: 

— Uses direct access or uses note or point in sequential access and will access data 
records whose relative record number is greater than 32,767. 

— References fields in the dscb, other than $dscbnam, $DSCBV0L, and the return code 
word (the label on the dscb). Most of the fields in the DSCB have new labels and 
certain fields have become two words long. 

— Uses $D1SKUT3. Word 3 of the request block is a double word in Version 5. If the 
rename function is being requested, the address of the new name is right adjusted in this 
2-word field. 

— Accesses or modifies supervisor control blocks. 

If the appUcation does not do any of the above, only recompilation or reassembly is 
required. 

The new diskette sector size and the disk resident table of contents do not affect existing 
applications. 






Conversion of Data 



The directory format on disk and diskette is different in Version 5 than it was in Versions 1 
and 2. This difference in directory format requires that data sets on disk and diskette written by 
Version 1 or 2 be converted to Version 5 format before they may be accessed by data 
management facilities. Three conversion aids ($migaid, $migrate, and $migcopy) and a 
diskette formatting program ($ssinit) perform the conversion. 



IS- 11 8 SC34-0646 



c 



Conversion of Data (continued) 

$MIGAID, executing on a Version 1 or 2 system, captures the contents of a disk volume on a 
series of diskettes called a save set. A save set produced by $migaid may be used as input to 
either $MIGRATE (to convert the saved data sets to Version 5 format) or to $MIGAID (to restore 
the data sets to their original Version 1 or 2 format). 

Note: To ensure data integrity when migrating from EDX Version 1 or 2 to EDX Version 5, an 
updated copy of $migaid must be added to the edx system. The updated copy of $migaid can 
be obtained through your local IBM Systems Engineer. In Version 1, it runs on VI. 3 ptf Level 
A (Version 1 Modification level 3) or later. In Version 2, it runs on V2.1 PTF Level 7. If you 
are currently running on Version 3 or are not converting to Version 5 from a previous version, 
you will not need this program. 

A diskette initiahzation utility, $SSINIT, also included on the FTP diskette, initializes and verifies 
the diskettes that $migaid uses. 

$MIGRATE, executing on a Version 5 system, reads the diskettes of the save set and produces, on 
disk, the Version 5 equivalents of the original data-type data sets captured by $MIGAID when it 
created the save set. Its input is a $MIGAID save set. 

$MIGRATE will not convert program-type data sets since, except in special cases. Version 1 or 2 
programs will not execute on Version 5 unless they are recompiled. 

$MlGCOPY, executing on a Version 5 system, converts data sets on Version 1 or 2 diskettes to 
'«>^ Version 5 data sets on either disk or diskette. $MlGCOPY uses many of the commands that 

$COPYUTl uses and functions in much the same way. $MlGCOPY will not process program-type 
data sets. $migcopy has an 'LA' command to Ust the contents of Version 1 or 2 format 
diskettes. 

To convert to the edx Version 5 data management environment: 

1 . Create an IPLable diskette containing the Version 1 or 2 $EDXNUC and starter utilities. 

2. Create a save set from the Version 1 or 2 disk (4962 or 4963) environment with $MIGAID. 

3. After installing edx Version 5, recover the relevant data sets from the save set with 
$MIGRATE. 

4. Convert Version 1 or 2 format diskettes as the need arises using $MlGCOPY. 

You may use $TAPEUTl to accomphsh the migration if you have a 4969 tape unit. This 
procedure is described in "Disk Conversion Procedure Using Tape" on page IS-I24. 

The $MIGAID save set and the IPLable diskettes are also the means for returning to the original 
environment, should that need arise. 
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Conversion of Data (continued) 

Disk Conversion Procedure Using Diskettes Produced by $MIGAID 

Use this procedure only if: 

1. You have installed a replacement $MIGAID module from a diskette dated October, 1983 or 
later. This diskette can be obtained from your IBM Systems Engineer. 

2. The system you are migrating from is at edx Version 1 Modification Level 3, PTF POA or 
EDX Version 2 Modification Level 1, PTF P07. 

If these conditions cannot be satisfied, an alternate procedure using $COPYUTl, $COPY, and 
$MlGCOPY is described later in this chapter. 

The procedure to follow, to ensure that you can return to Version 1 or 2 as well as to proceed to 
Version 5, is: 

1. Make an IPLable Version 1 or 2 diskette with the minimum starter utiUties. If you have two 
diskette drives, you may use $C0PYUT1 to copy the distributed starter system diskette 
(UT3001 or UT4001). If not, you will need to construct a diskette containing the minimum 
starter utiUties. 

In either case, proceed as follows: 

a. Use SVARYON to vary the diskette online. 

b. Use SINITDSK to initialize the diskette you will be using. 

1 ) Use the id command to write the volume label and the owner id with names of your 
choice. 

2) Allocate a directory of 60 records. 

3) Allocate a 64K $EDXNUC. 

4) Write IPL text. 

c. Use SDiSKUTl (LA command) to list all supervisor programs. You may maintain multiple 
supervisor programs and need to decide which versions you want to save. 

d. Use $COPYUTi to copy your $EDXNUCx on disk to diskette. 

If you have two diskette drives, use the $COPYUTi call command to copy all the data sets 
on the starter system diskette to the diskette you are constructing. 
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Conversion of Data (continued) 



If you have only one diskette unit, use the $COPYUTi CM command to copy individually the 
following from the IPL volume on disk to the diskette: 

$4978130 $IOTEST 

$4978CS0 $INITDSK 

$4978CS1 $LOADER 

$C0PYUT1 $LOGUT00 

$DASDI $14962 

$DISKUT1 $14963 

$DISKUT2 $TERMUT1 
$IDSKETT 



2. Copy $MIGAID to this diskette. 

3. To ensure that you can reconstruct your system, IPL from this diskette. 

4. Save this diskette! This is your only vehicle for rebuilding your current disks. 

5. IPL the disk and allocate the $MIGAID work file (see example, below). Do not allocate your 
work file in the volume you are going to save. 

6. Use $SSINIT to initialize the diskettes for use by $MIGAID. The number of diskettes required 
to save the contents of a volume depends upon the amount of data allocated on that volume. 

7. Use $MIGAID to save the contents of your volumes on diskettes. 

8. Install the Event Driven Executive using the procedures outlined in the Version 5 Program 
Directories. 

9. Run $MIGRATE to copy the diskettes to your Version 5 disks. 
Examples of this procedure are given below. 

To return to the Version 1 or 2 environment, proceed as follows: 

1. IPL the diskette you built in steps 1, 2, and 3, above. 

2. Execute $INITDSK to initialize your volumes on disk. 

3. Allocate the $MIGAID work file on disk. 

4. Load $MIGAID and execute the restore (re) function. 

You may remove the ipl diskette at this time; insert the saved diskettes as prompted by 
$MIGAID. 
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Conversion of Data (continued) 



Disk Conversion Procedure Using Diskettes Produced by $C0PYUT1 or $COPY 

The procedure to follow, to ensure that you can return to Version 1 or 2 as well as to proceed to 
Version 5, is: 

1. Make an IPLable Version 1 or 2 diskette with the minimum starter utilities. If you have two 
diskette drives, you may use $copyuti to copy the distributed starter system diskette 
(UT3001 or UT4001). If not, you will need to construct a diskette containing the minimum 
starter utiUties. 

In either case, proceed as follows: 

a. Use $VARYON to vary the diskette online. 

b. Use $INITDSK to initialize the diskette you will be using. 

1 ) Use the id command to write the volume label and the owner id with names of your 
choice. 

2) Allocate a directory of 60 records. 

3) Allocate a 64K $edxnuc. 

4) Write IPL text. 

c. Use $DISKUT1 (LA Command) to list all supervisor programs. You may maintain multiple 
supervisor programs and need to decide which versions you want to save. 

d. Use $COPYUTl to copy your $EDXNUCx on disk to diskette. 

If you have two diskette drives, use the $copyuti call command to copy all the data sets 
on the starter system diskette to the diskette you are constructing. 

If you have only one diskette unit, use the $C0PYUT1 CM command to individually copy the 
following from the ipl volume on disk to the diskette: 






$4978150 

$4978CS0 

$4978CS1 

$C0PYUT1 

$DASDI 

$DISKUT1 

$DISKUT2 

$IDSKETT 



$IOTEST 

$INITDSK 

$ LOADER 

$LOGUTOO 

$14962 

$14963 

$TERMUT1 

$COPY 



C 
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Conversion of Data (continued) 



2. To ensure that you can reconstruct your system, IPL from this diskette. 

3. Save this diskette! This is your only vehicle for rebuilding your current disks. 

4. IPL the disk. 

5. Use $DISKUT1 (LA command) to list the names and sizes (in 256 byte records) of all the data 
sets on each volume on your disk. You may want to refer to this list so obtain a hard copy 
of it. 

6. Use the $initdsk and DASDI utilities to prepare a supply of diskettes to hold the data 
included for conversion. Use a systematic sequence of volume names to assist you in 
keeping the diskettes in order. 

7. Use $COPYUTl to copy each data set from disk to diskette (in Version 1 or 2 format). If any 
data sets are too large to fit on a diskette, keep a record of its name, and continue the copy 
process. 

8. To copy a data set that is too large to be copied in the previous step, break the data set into 
portions and copy each portion to a diskette using the $COPY utility. To do this: 

a. Use $INITDSK to initialize each diskette with a directory for one data set. 

b. Use $DISKUT1 to allocate the largest possible data set on each diskette prior to copying 
the data set. If you are using a Diskette 1 , the largest data set you can allocate is 946 
records; for a Diskette 2, the largest data set is 1921 records. 

c. Keep track of the number of records you copy to each diskette. In addition, keep track 
of the order and number of diskettes you used to copy to each data set. You will need 
this information when the data set is copied and reassembled into one data set on the 
target system. 

9. Install the Event Driven Executive using the procedures outlined in the EDX Version 5 
Program Directory. 

10. Run $MlGCOPY to copy your Version 1 or 2 diskettes to your Version 5 disk. 

11. Consider copying the fragmented data sets that were created by $COPY first. To do this: 

a. Use $MiGCOPY to copy all diskette portions of a data set to disk. 

b. Allocate a disk data set of the original name and size. 
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Conversion of Data (continued) 

c. Use $COPY to reassemble the data set by record numbers. 

d. Delete the data set portions from disk, leaving the assembled data set. 

e. Repeat steps 1 through 4 for each fragmented data set. 
12. To return to the Version 1 or 2 environment: 

a. IPL the diskette built in steps 1 and 2 above. 

b. Initialize your volumes on disk using $INITDSK. 

c. Copy your Version 1 or 2 diskettes back to your Version 1 or 2 disk using $C0PYUT1. 
(This procedure is identical to step 10, above, except that $C0PYUT1 is used to copy data 
set instead of $MIGC0PY). 

Disk Conversion Procedure Using Tape 

To use tape as your conversion medium, proceed as follows: 

1. Save the Version 2 disks for backup: 

a. Create a diskette that you can IPL by using the initialize device command (ID) of the 
$INITDSK utility. Then use the copy member command (CM) of $COPYUTi to copy 
$LOADER and the copy generic command (CG) to copy the $TAPExx members. 
$INITDSK and $COPYUTl are described in the Operator Commands and Utilities Reference. 

b. Use the save tape (st) function of $tapeuti to save the contents of each disk device. 

If you need to restore your Version 2 system, IPL the diskette created in l.a above, then use 
the tapes created in l.b above to re-create the Version 2 disks. The $tapeuti restore tape 
(rt) command is used to restore from tape to disk. 

2. Save selected data sets for use with Version 5: 

a. Use the copy data set (CD) function of $tapeuti to copy the data sets to tapes that you 
wish to use (or have available for use) in your Version 5 system. 

b. After you have installed Version 5, use the Version 5 $TAPEUT1 copy data set (CD) 
command to copy the data sets from tape to disk, using the tapes created in 2.a above. 

Of course, you must use $MiGCOPY to convert diskettes. 



f J 
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Conversion of Data (continued) 

Diskette Conversion Procedure 

To convert diskettes: 



1. After you install Version 5, use $INITDSK to allocate and initialize a 2000-record disk work 
volume. 

2. Use $MlGCOPY to copy the diskette to be converted to the work volume. 

3. Save the diskette (see Note on the following page). 

4. Initialize a different diskette, using $INITDSK. 

5. Use the copy all (call) function of $COPYUTl to copy the contents of the work volume to 
the diskette created in number 4 above. 

6. Use $INITDSK to delete the work volume. 

If your system has two diskette devices, you may copy from diskette to diskette by following this 
procedure: 

1. Use $INITDSK to initialize a diskette. 

2. Use SMIGCOPY to copy from your diskette to the new diskette. 

Note: You should not destroy the Version 1 or 2 diskettes or the diskettes built by $MIGAID 
until you are satisfied that you have: 

• Finished migrating all data. 

• Completed conversion from Version 1 or 2 to Version 5. 

Once these diskettes are reused, you have lost your ability to recover data or to return to the 
Version 1 or 2 operating environment. 



Conversion Utilities 



Three conversion aids ($MIGAID, $MIGRATE, and $MlGCOPY) and a diskette formatting program 
($SSINIT) perform the conversion. A description of each follows. 
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Conversion Utilities (continued) 



$MIGAlDand$SSINIT 



^'^ 



K. 



$MIGAID captures the contents of each Version 1 or 2 volume you elect to migrate by writing 
them to diskettes. $SSiNn initializes these diskettes. With these diskettes, you can either restore 
your current environment or place selected contents of the diskettes on your Version 5 disks. 

Note: Use $MIGAID and $SSINIT on your EDX Version 1 or 2 system only if: 

1. You have installed a replacement $MIGAID module from a diskette dated October, 1983 or 
later. This diskette can be obtained from your IBM System Engineer. 

2. The system you are migrating from is at EDX Version 1 Modification Level 3, PTF POA or 
EDX Modification Level 1, PTF P07. 

The $MIGAID save function (SA) requires a work data set that must be at least one record larger 
than the directory of the volume to be processed. The restore (re) function also requires a work 
data set of the same size. To determine the size of the work data set, proceed as follows: 

1. Load $DISKUT1. 

2. Change volume (cv) to the volume to which you are migrating. 

3. Issue an LS command (the directory size is displayed on your terminal). 

4. Reply N to the list prompt. 

5. End the utility. 



For example, to obtain the directory size of EDX003: 



/• 



> $L $DISKUT1 

LOADING $DISKUT1 63P, 13:05:58, LP=9200, PART=1 

$DISKUT1 - DATA SET MANAGEMENT UTILITY I 

USING VOLUME EDX002 

COMMAND (?): CV E0XO03 

COMMAND {?): LS 

USING VOLUME EDX003 



A 



LIBRARY 
AT RECORD 
SIZE 
UNUSED 

DIRECTORY 
SIZE 
UNUSED 



1 
32640 RECORDS 
17736 RECORDS 



60 RECORDS 
11520 BYTES 



V. 



NO. MEMBERS - 1l8 
NO. FREE SPACE ENTRIES 
LIST FREE SPACE CHAIN? 



k ^ 
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Conversion Utilities (continued) 



You have found that your work data set must be 61 records (directory size 60, plus one). 

Proceed now to allocate and clear the data set, using $DISKUT1,AL and $DISKUT2,CD. Do not 
allocate this work data set on the volume you are going to process. For example, allocate 

MIGWORK on EDX002: 

USING VOLUME EDX002 

COMMAND (?): AL MIGWORK 61 Y 
MIGWORK CREATED 

COMMAND (?): EN 

$DISKUT1 ENDED AT 13:15:57 






To clear the data set: 



>$L $DISKUT2 

LOADING $DISKUT2 51P , 13 : 19: 1 1 , LP= 9200, PART=1 

$DISKUT2 - DATA SET MANAGEMENT UTILITY II 

USING VOLUME EDX002 

COMMAND (?): CD MIGWORK 
CLEAR ENTIRE DATA SET? Y 

ARE ALL PARAMETERS CORRECT? Y 
CLEAR COMPLETED 

COMMAND (?): EN 

$DISKUT2 ENDED AT 13:19:38 



Now you are ready to load $MIGAID; it will prompt for your work file name and volume. For 
example: 



^ 



>SL SMIGAID 

WORKF I LE ( NAME , VOLUME ) : Ml GWORK , EDX002 
$MIGAID 4itP,l'*:05:07, LP= 0000 
COMMAND (?): 



o 



Do not delete or clear this work file until you have completely processed an entire volume. 
$MIGAID records in the work file the data sets that have been processed and other internal 
information, allowing you to stop the process and resume without having to restart from the 
beginning. 

Now you are ready to start the save (sa) process. For obvious reasons (data integrity, 
completeness, and accuracy) $MIGAID must be the only active program in your system. 
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Conversion Utilities (continued) 



Displaying $MIGAID Commands 



To display the $MIGAID commands at your terminal, enter a question mark (?) in response to the 
prompting message command (?):. 



r 



K. 



COMMAND (?): ? 

$MIGAtD — MIGRATION AID UTILITY 

$MI6AID ACCEPTS THE FOLLOWING COMMANDS: 

? -- HELP. PRINTS THE FOLLOWING LIST OF COMMANDS 

AND EXPLANATIONS. 
EN — END. COMMAND TO END $MIGAID. 
PR — PRINTER, NAME THE LOGICAL PRINTER TO WHICH 

LOGS SHOULD 60. "PR "" MEANS THE CURRENT 

TERMINAL. DEFAULT: "PR $SYSPRTR" 
RE — RESTORE. RESTORE DATA SAVED WITH THE 

"SA" COMMAND TO A VERSION 1 or 2 SYSTEM, 
SA — SAVE. SAVE DATA FROM A VERSION 1 or 2 D t SK 

VOLUME ON DISKETTE(S) FOR LATER TRANSFER 

OR RESTORE 

IN ADDITION $MIGAIO HAS THE FOLLOWING 
'ATTENTION' COMMANDS: 

STOP -- STOP A SAVE OR RESTORE THAT IS IN PROCESS 
GO -- CAUSE $MIGAID TO START AGAIN WHEN IT HAS 
PAUSED FOR MORE DISKETTES. 



^ 



You can use these commands to perform the following functions: 






EN 



End SMIGAID. Use en to terminate $MIGAID. EN can be entered any time the 
COMMAND (?): prompt appears. 



PR 



Assign printer. Use PR to select the device used for printing the log. The default is 
$SYSPRTR; entering PR * causes the log to print on your terminal. It is recommended 
that a hard-copy device be used because the log records the name of each data set 
copied, the number of records copied, and shows the contents of each diskette. 



RE 



Use RE to restore from diskette to disk. Restore (re) copies data sets previously 
saved with the $migaid SA command from diskette and places them on a Version 1 
or 2 disk. 



SA 



Use SA to save from disk to diskette. Save (SA) copies data sets from disk to 
diskette. SA also calculates and tells you the number of diskettes required to contain 
the specified volume. Since it saves data sets, it prints the log on the device you 
specified (or defaulted) in the PR command. 



o 
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Conversion Utilities (continued) 



gf^ 



$MIGAID also has two attention commands. You can enter these commands after you have 
pressed the ATTN key, or its equivalent, and have received the > prompt. The attention 
commands are: 

STOP Directs $MIGAID to stop processing when it reaches the end of the data set it is 

copying, whether the operation is an SA or an re. When SMIGAID stops, the log is 
printed to show where you terminated the operation. 

GO Directs $MIGAID to resume processing. Use GO when you have mounted the 

required diskettes. 

Example 1 - Preparing to Create a Save Set: This example shows how to determine the 
number of diskettes required to contain LIB002, and how to initialize these diskettes. 

/ >^ 

COMMAND (?): SA 

NAME OF VOLUME TO MIGRATE: L I B002 

SAVE SET NAME (1-^ CHARS): X 

MIGASDV - SAVE THE DATA FROM VOLUME L I B002 

ON SAVE SET X 
MIGANDR - THIS SAVE REQUIRES 5 TWO SIDED DISKETTES. 

THE DISKETTES SHOULD BE FORMATTED FOR 

EDX BY SSSINIT AND HAVE A DIRECTORY 

120 RECORDS IN SIZE. THEY SHOULD NOT 

HAVE SPACE FOR A NUCLEUS RESERVED. 

THE VOLUME LABELS SHOULD BE XOl 

THROUGH X05. THE SAVE WILL START WITH 

DISKETTE XOl 
MIGALDI - LOG WILL GO TO SSYSPRTR 



''■''■' DATA ON THE DISKETTES WILL BE OVERWRITTEN 
MIGAACCL - CONTINUE (Y/N): N 
COMMAND (?): EN 



Five diskettes are required to contain LIB002. Load $SSINIT to initialize the five diskettes. 
SSSINIT prompts you for: 

• The number of diskettes in the save set 

• The volume label to be used 

• The owner identification characters 

• The device address. 

When you have completed these replies, SSSINIT prompts you to insert a diskette. After inserting 
the diskette, press the enter key. Four information messages will appear, followed by the 
prompt for another diskette. This process is repeated until the save set initialization and 
verification is completed. 
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Conversion Utilities (continued) 



As you process a diskette, $ssinit appends a sequence number to the volume prefix you entered 
to create a volume label for the diskette. Remember to write this volume label on the external label 
of the diskette. These volume labels are your identification for these diskettes. 

Do not use the EDX $varyon/$varyoff commands when changing diskettes. 

If you are using a 4966, each diskette must be in address slot one, as specified in the prompt 
message. 

In this example, xoi through X05 are the volume labels of the diskette. The example shows how 
to initialize these diskettes: 

> $L $SSINIT 

$SSINIT 23P,07:i»4:31, LP= 2900 

ENTER NO. OF DISKETTES IN SAVE SET: 5 

ENTER VOLUME LABEL FOR SAVE SET (1-4 CHARS): X 
ENTER OWNER ID (1-14 CHARACTERS): SAVE DISKETTES 

ENTER DEVICE ADDRESS IN HEX: 2 
XOI INITIALIZATION STARTED 

XOI DIRECTORY INITIALIZED 

XO) DISKETTE VERIFICATION STARTED 

XOI 1924 RECORDS CHECKED 
INSERT NEW DISKETTE AT lODA = 0002 
THEN PRESS ENTER TO CONTINUE 



INSERT NEW DISKETTE AT I ODA = 0002 
THEN PRESS ENTER TO CONTINUE 
X05 INITIALIZATION STARTED 

X05 DIRECTORY INITIALIZED 

X05 DISKETTE VERIFICATION STARTED 

X05 1924 RECORDS CHECKED 

DO YOU HAVE ANOTHER SAVE SET TO INITIALIZE? N 






X^^J 



V 
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The process of initializing and verifying these five diskettes should take approximately five 
minutes. 

When the save set initialization is complete, you are ready to start the save process. 

If an I/O error occurs while processing a diskette, the following messages appear on your 
terminal: 



ERROR 5 AT RECORD 222 

XOl 195 RECORDS CHECKED 

CONTINUE WITH INITIALIZATION OF THIS SAVE SET? 



"*\^ 



In this example, the READ/ write retjjrn code is 5, and the failure occurred at record 222 on the 
XOl diskette. 

$SSINIT allows you to either continue or end the save set initialization. To end, reply with an N; 
to continue reply with a Y. The following example shows the continue option. 



INSERT NEW DISKETTE AT I ODA = 0002 
THEN PRESS ENTER TO CONTINUE 

XOl INITIALIZATION STARTED 

XOl DIRECTORY INITIALIZED 

XOl DISKETTE VERIFICATION STARTED 



V. 



XOl 1924 RECORDS CHECKED 



$SSINIT resumes with the failing volume label. 
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Example 2 - Create a Save Set: This example shows the sequence of events necessary to 
actually carry out the save prepared for in example 1 . It then examines the log produced during 
the operation. The example begins with the save (sa) command of $MIGAID. 



r 



v^ 



COMMAND (?): SA 

VOLUME TO MIGRATE {"*" FOR CURRENT DEFINITION): * 

(This prompt not the same as the one in Example l) 

MIGASDV - SAVE THE DATA FROM VOLUME LIB002 ON SAVE 
SET X 

MIGANDR - THIS SAVE REQUIRES 5 TWO SIDED DISKETTES, 
THE DISKETTES SHOULD BE FORMATTED FOR EDX 
BY $SSINiT AND HAVE A DIRECTORY 120 RECORDS 
IN SIZE. THEY SHOULD NOT HAVE SPACE FOR A 
NUCLEUS RESERVED. THE VOLUME LABELS SHOULD 
BE X01 THROUGH X05. THE SAVE WILL START 
WITH DISKETTE X01 

MIGALDI - LOG WILL GO TO $SYSPRTR 

-**** DATA ON THE DISKETTES WILL BE OVERWRITTEN ""**= 
MIGAACQ - CONTINUE? (Y/N): Y 
MIGAOSC - OPERATION SUCCESSFULLY COMPLETED. 
COMMAND (?): 



^ 



In this example, the save set name used is X. Since $MIGAID has determined that five diskettes 
are required, diskettes labeled XOl through X05 will be required. This save requires 
approximately 12 minutes. 

The log below shows the name and size of each data set. In this example, the diskettes were 
mounted in the A magazine of a 4966, so there is no manual intervention required to change 
diskettes. 



The contents of the log ($sysprtr) are: 



MIGASHM - LOG OF SAVE FROM VOLUME LIB002 




MIGACDS - DATA SETS COPIED FROM LIB002 


TO XOl 




DLETEMPI (PART) 






MIGACDS - DATA SETS COPIED FROM LIB002 


TO X02 




DLETEMPI 1805 DLETEMP 1803 






MIGACDS - DATA SETS COPIED FROM LIB002 


TO X03 




DLETEMP 2 (PART) 






MIGACDS - DATA SETS COPIED FROM LIB002 


TO X04 




DLETEMP 2 1806 DLETEMP 3 1802 






MIGACDS - DATA SETS COPIED FROM LIB002 


TO X05 




DMINTRFS 273 DMINTRFO 60 $MIGAID 64 


$MIGAIDO 


100 


$MIGAIDL 150 $MIGAIDC 2 TSTUT3 42 


$MIGAIDS 


679 


MIGADSC - OPERATION SUCCESSFULLY COMPLETED. 
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The above log means: 

• The first part of dletempi is on diskette XOl. 

• The remainder of DLETEMPI and DLETEMP are on diskette X02. 

• The first part of DLETEMP2 is on diskette X03. 

• The remainder of DLETEMP2 and DLETEMP3 are on diskette X04. 






^ 



• Diskette X05 contains eight data sets. 

The $MIGAID restore (re) command will rebuild the split data sets DLETEMPI and DLETEMP2 in 
their proper form, as will $migrate. 

Example 3 - Restoring a Volume: The following example of the restore (re) function 
shows a restore of EDX003 from save set MJG. The diskettes were read from a 4964 diskette 
unit. This example takes approximately five minutes, including the time to replace ($VARY0n) 
the diskette. 



r 



> $L $MIGAID 
WORKFILE(NAME, VOLUME): MIGWORK 
$MIGA!D 53P, 00:^^:39, LP= 0000 

COMMAND (?): RE 

VOLUME TO MIGRATE (""" FOR CURRENT DEFINITION): 

SAVE SET NAME {]-k CHARS): MJG 

MIGARDV - RESTORE THE DATA TO VOLUME EDX003 FROM 

SAVESET MJG THE RESTORE WILL START WITH 

DISKETTE 1 
MIGALD! - LOG WILL GO TO $SYSPRTR 
MIGAACQ - CONTINUE? (Y/N): Y 
MIGAPMV - MOUNT VOLUME MJG01 AND VARY IT ONLINE 

TYPE 'ATTN GO' WHEN READY 

OR 'ATTN STOP' TO ABORT MOUNT 

> $VARYON 2 
MJGOl ONLINE 

> GO 

MIGAPMV - MOUNT VOLUME MJG02 AND VARY IT ONLINE 
TYPE 'ATTN GO' WHEN READY 
OR 'ATTN STOP' TO ABORT MOUNT 

> $VARYON 2 
MJG02 ONLINE 

> GO 

MIGAOSC - OPERATION SUCCESSFULLY COMPLETED 
COMMAND (?): 



A 



EDX003 
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The contents of the log (SSYSPRTR) are: 



MIGARHM - LOG OF RESTORE TO VOLUME EDX003 

MIGACDS - DATA SETS COPIED FROM MJG01 TO EDX003 
$SM2GRIZ 400 $SM3GRIZ 250 $SMPJEFF 30 $SM1GRIZ 400 
$SMPGRIZ 30 $SMWGRIZ 30 $SMEGRIZ 400 MJGPOI 5 
MJGSRCl 50 MJGEDIT 50 MJGWRK 100 MJGAOBJ 500 
MJGP02 4 SCREEN03 3 

MIGACDS - DATA SETS COPIED FROM MJG02 TO EDX003 
SCREEN02 3 SCREEN01 3 DEM01 39 DEJOBS 100 
DEMAPS 100 



Save set mjg was two diskettes, MJGOl and mjg02. Diskette MJGOi contained 14 data sets. 
Diskette MJG02 contained five data sets. 

Error Handling during $MIGAID Processing 

Errors may occur during $MIGAID processing. The utility handles the following error conditions: 

A disk or diskette unit fails. 

The system fails and you must IPL again. 

You decide to have $migaid suspend the operation in progress., 

You specify an invalid volume for the save (SA) or restore (re). 

You mount the wrong diskette in response to a volume mount request, or you do not have 

the requested volume. 

Example 1 - Disk or Diskette Unit Failure: If the output device fails while writing data, 
the following appears on your terminal: 



^ 



MIGAWDF - WRITE DATA FAILED FOR FILENAME D I SK 1 RC=x 

ERROR OCCURRED ACCESSING BLOCKS mmmmm - nnnnn 
MIGACFA - COPY OF THIS FILE ABANDONED 



\_J 



J 



where x is the READ/WRITE return code and mmmmm - nnnnn is the record range in the data set 
in which the failure occurred. 
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\ 



.^ 



Following a disk read failure, $MIGAID attempts to continue saving or restoring the next data set. 
If $MIGAID encounters a read error on diskette, it attempts error recovery. Error recovery is 
signaled by the message: 

I MIGAERS - ERROR RECOVERY PROCEDURE STARTED I 

If the error recovery is successful $migaid displays the message: 

I MIGASER - ERROR RECOVERY SUCCESSFUL J 

and processing continues normally. 

If error recovery is not successful, $MIGAID displays: 



MIGABNR - BLOCK nnnnnn OF dsnamel ON volnml NOT RESTORED 
BECAUSE OF READ ERROR AT BLOCK mmmmmm 
OF dsnameZ ON vo1nm2 DISKIO RC= iiiili 

MIGAUER - ERROR RECOVERY UNSUCCESSFUL 



This error indicates that block nnnnnn on the disk data set (dsnamel, volnml) was not correctly 
restored because block mmmmmm on the diskette data set (dsname2,volnm2) could not be read. 
$MIGAID has placed whatever data the diskette unit was able to read from the input block into 
the output block. Since the read did not complete without error, block mmmmmm of the disk 
data set may contain incorrect information. You should check carefully any block that $migaid 
was unable to recover. Whenever $migaid is not able to recover from a diskette read error, it 
prompts: 

I MIGAATF - ABANDON THIS FILE? (Y/N): J 

If you reply 'Y' to this prompt, $MIGAID ceases to process the data set that had the error and 
starts processing the next one. A reply of 'N' causes $MIGAID to continue processing the file. 
Any unsuccessful error recoveries are noted in the log. If an I/O error occurs during access to a 
disk or diskette directory, the following message appears on your terminal: 

MIGAIED - I/O ERROR READING DIRECTORY ON VOLUME 

DISKIO RC=x 
MIGACOA - OPERATION ABANDONED 



where x is the read/write return code. 



Chapter 6. Migrate to Version 5 IS- 135 



Migrate to Version 5 



Conversion Utilities (continued) 



L 



COMMAND (?): SA " 



if you are resuming a save or 

I COMMAND (?): RE * 



if you are resuming a restore. $migaid resumes processing, using its work file status. 

In a system failure, the report on the log device may not show as many as three data sets. Use 
the $DISKUT1 (LA) command to get a complete list of the diskette data sets. 






This message indicates that $MIGAID has encountered an error so serious that it cannot continue 
until the problem is corrected. $migaid then returns to command input mode. The work file 
contains the correct status to continue the operation after the problem has been corrected. 
$MIGAID may be shut down completely (with the EN command) while the correptions are made 
without loss of restart information. 

After correcting a problem, you can resume $migaid by entering an * in response to the 
following prompt: 

I VOLUME TO MIGRATE ("*" FOR CURRENT DEF IN ITI ON) : J 

or by entering SA * to the command (?): prompt. 

Either of these responses directs $migaid to use the status in the work file to resume the save 
process. A similar procedure, using the RE command, can be used to resume an aborted restore 
process. Note that when the message: ^ 

I MIGACFA - COPY OF THIS FILE ABANDONED J 

is issued, the data set has not been properly saved (or restored) and its contents are undefined. 
The log will then contain a note that there was an error in the processing of the data set. 

Example 2 - System Failure: To recover from a system failure, ipl again, load $MIGAID, ^4^ 

and respond: 



' ; 
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An example of restart: 



r 



$L $MIGAID,LIB002 
WORKF I LE( NAME, VOLUME): 



$SM3DLE,EDXO03 



$MIGAID 53P, 16:13:^2, LP= 0000 

COMMAND (?): SA " 

MIGASDV - SAVE THE DATA FROM VOLUME L I B002 ON SAVE SET X 

MIGANDR - THIS SAVE REQUIRES 5 TWO SIDED DISKETTES. 

THE DISKETTES SHOULD BE FORMATTED FOR EDX BY 
$SSINIT AND HAVE A DIRECTORY 120 RECORDS IN 
SIZE. THEY SHOULD NOT HAVE SPACE FOR A NUCLEUS 
RESERVED. THE VOLUME LABELS SHOULD BE X01 
THROUGH X05. 
THE SAVE WILL START WITH DISKETTE X04 

MIGALDI - LOG WILL GO TO $SYSPRTR 

""**" DATA ON THE DISKETTES WILL BE OVERWRITTEN **""* 
MIGAACQ - CONTINUE? (Y/N): Y 



As you can see from this example, $migaid will resume processing where it left off. 



The log from the restart looks like: 



MIGASHM - LOG OF SAVE FROM VOLUME LIB002 

MIGACDS - DATA SETS COPIED FROM LIB002 TO X04 
DLETEMP3 1802 

MIGACDS - DATA SETS COPIED FROM LIB002 TO X05 

DMINTRFS 273 DMINTRFO 60 $MIGAID 64 $MIGAIDO 100 
$MIGAIDL 150 $MIGAIDC 2 TSTUT3 42 $MIGAIDS 679 

MIGADSC - OPERATION SUCCESSFULLY COMPLETED. 
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Example 3 - Suspend an Operation: To cause $migaid to suspend an operation in 
progress, press the attention key (or its equivalent), and enter STOP. 

Your terminal will look like this after $migaid stops: 



> STOP 

MIGAMSD - $MIGAID SHUTTING DOWN SHORTLY 
MIGASBU - OPERATION SUSPENDED BY USER 
COMMAND (?): 



$MIGAID completes processing the current data set, prints the log, and issues the command 
prompt. 

In this case, the log and the work file reflect the correct status. Use SA ♦ or RE * to resume, when 
you are ready. 



Example 4 - Invalid Volume Name: If you respond with an invalid name, $migaid reissues 
the prompt: 



COMMAND (?): SA XYZZY X 

MIGACOL - CAN'T OPEN LIBRARY ON XYZZY 

(LIBRARY NOT FOUND) 
COMMAND (?): 



V. 



Example 5 - Wrong Diskette Inserted: If you insert the wrong diskette, $MIGAID reissues 
the message: 



/^~"\ 
w V 



MIGAPMV - MOUNT VOLUME vol name AND VARY IT ONLINE 
PRESS "ATTN" AND TYPE "GO" WHEN READY 
OR "STOP" TO ABORT MOUNT 



At this point you may mount the correct diskette and proceed normally. If you do not have the 
requested diskette, you may abort the mount request by pressing the attention key and typing 
STOP, as directed. If you choose to abort the mount request, $MIGAID will type the following on 
your terminal: 



> STOP 

MIGAMSD - SMIGAID SHUTTING DOWN SHORTLY 
MIGAVMA - VOLUME MOUNT ABORTED 
MIGACOA - OPERATION ABANDONED 
COMMAND (?): 



\J 
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$MIGRATE 



$MIGRATE, part of Version 5, converts $MIGAID output to Version 5 format. If you are not 
converting to Version 5 from a previous version of EDX, you do not need this program. 

Note: $MIGRATE (on EDX Version 5) can be used successfully only if the diskettes being read 
were created under the following circumstances: 

1 . The $MIGAID program on the Version 1 or 2 system was obtained from a diskette dated 
October, 1983 or later. This diskette can be obtained from your IBM Systems Engineer. 

2. The EDX system producing the diskettes was at either edx Version 1 Modification Level 3 
PTF POA or EDX Version 2 Modification Level 1 FTP P07. 

SMIGRATE uses a work data set which you must allocate with SDISKUTI and clear with $DISKUT2 
before you invoke $MIGRATE for the first time. The $MIGRATE work data set must be at least 
121 records in size. When converting a $MIGAID save set, $MIGRATE keeps checkpoint and other 
internal information in its work file, allowing $migrate to recover from power or other system 
failure. Do not delete or clear a $MIGRATE work data set until $MIGRATE has successfully 
completed a restore operation. Do not allocate the $MIGRATE work file on the disk volume that 
is being restored (the target volume) since, if there is a data set of the same name on the save 
set, the work file would be replaced with the saved data. 



$MIGRATE Commands 



$MIGRATE accepts the following commands: 

? Help. Prints the following Ust of commands and explanations. 

EN End. Command to end $MIGRATE. 

PR Printer. Names the logical printer to which logs should go. 'PR *' means the 

current terminal. Default: PR $SYSPRTR 

RE Restore. Restores all data members saved with the Version 1 or 2 utility 

$MIGAID to a Version 5 disk. 

RG Restore generic. Similar to RE but restores only data members having names 

starting with the generic text you supply. 

RN Restore nongeneric. Similar to RG but restores only data members having names 

that do not start with the generic text you supply. 
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$MIGCOPY 



In addition $migrate has the following attention commands: 

STOP Stops a restore that is in process. 

GO Causes $migrate to start again when it has paused for more diskettes. 

$MIGRATE is much Uke the restore portion of its Version 1 and 2 counterpart, $migaid, with the 
addition of the abiUty to restore only those data sets that match (or do not match) a given 
generic string. Error recovery procedures and error message sequences for $MIGRATE are 
identical to those for $migaid. 



The $MlGCOPY program copies data sets on diskette in Version 1 or 2 format to either disk or 
diskette in Version 5 format. If you do not have any Version 1 or 2 format diskettes, you do not 
need this program. 

$MIGCOPY operates very much like $COPYUTl with the following exceptions: 

• Its input (source) data set format is Version 1 or 2. 

• Its output (target) data set format is Version 5 . 

• It does not copy program-type data sets (Version 1 or 2 programs will not run on Version 5 (^ 



unless they are recompiled). 

• It has a $DiSKUTi-like "LA" command to list the contents of the Version 1 or 2 source 
diskette. 

$MIGCOPY Commands 

$MlGCOPY accepts the following commands: 

? Help. Prints the following list of commands and their explanations. 

EN End. Command to end $migcopy. 

CM Copy Member. Copies a specific data member from the Version 1 or 2 source 

volume to the Version 5 target volume. 

CALL Copy All. Copies all data members from the Version 1 or 2 source volume to the 

Version 5 target volume. 

CG Copy Generic. Similar to call but copies only data members having names 

starting with the generic text you supply. 

CNG Copy nongeneric. Similar to CG but copies only data members having names that 

do not start with the generic text you supply. 
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CV Change volume. Changes the source and target volumes that will be used. 

LA Lists all members on source volume. 

SQ Turns question mode on for all multiple copy operations. 

NQ Turns question mode off. (This is the default.) 

In addition, $MlGCOPY has the following attention commands: 

STOP Stop an in-process multiple copy. 

GO Cause SMIGCOPY to start again when it has paused for a volume mount. 

STOP and GO are entered to get $MIGCOPY's attention when it is doing a multiple copy operation 
or when it has paused for you to mount a diskette. To enter an attention command, press the 
attention key (or its equivalent). The system responds with ">" indicating its readiness to 
accept an attention command. Type the command and press the enter key. 

During a multiple copy command, the STOP command causes SMIGCOPY to stop after it has 
finished processing the data set it is copying. 

If SMIGCOPY needs a diskette that is not mounted, it pauses and asks you to mount it. The GO 
attention command is used to inform SMIGCOPY that the requested diskette is mounted. 

Example 1 - Loading $MIGCOPY: After Smigcopy is loaded, it prompts you for the 
names of the source (input) diskette volume and the target (output) volume. The source volume 
must be in Version 1 or 2 format and the target in Version 5 format. For example: 

> $L SMIGCOPY 

SMIGCOPY 50P, 01:00:08, LP= 0000 
SOURCE VOLUME: RECOVR 
TARGET VOLUME: EDX005 



The source and target volumes may be changed later by using the CV command. 
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Example 2 - Using the List All (LA) Command : The LA command may be used to list the 
names of the data sets on the source volume. $DISKUT1, which is usually used to list volume 
contents, executes only on Version 5 format diskettes. To list Version 1 or 2 diskettes, use the 
$MlGCOPY LA command. For example: 



n 



COMMAND(?): LA 

MIGCLOO - LISTING OF DATA SETS ON RECOVR 

NAME TYPE SIZE 



$EDXNUC 


PGM 


257 


$SMMLOG 


DATA 


2 


$SMMPRIM 


DATA 


2 


$SMM0203 


DATA 


k 


$SMP01 


DATA 


8 


$SMM02 


DATA 


6 


$SMM0201 


DATA 


k 


$SMM0202 


DATA 


k 


$SMP0i»01 


DATA 


11 


$SMM020i» 


DATA 


4 


$SMM0205 


DATA 


2 


$SMM0206 


DATA 


2 


$SMM0207 


DATA 


2 


$SMM0208 


DATA 


2 


$SMM0209 


DATA 


k 


$SMP02 


DATA 


11 


$SMP0203 


DATA 


23 


$SMP0202 


DATA 


19 


$SMP0209 


DATA 


28 


$SMPPRIM 


DATA 


31 


$L0GUT00 


PGM 


6 


$SMCTL 


PGM 


kk 


$TERMUT1 


PGM 


\k 


SSMLOG 


PGM 


33 


$MIGAID 


PGM 


77 


$SSINIT 


PGM 


25 



(f 



,y 



Note that although the LA command lists all data sets on the diskette, the copy commands will 
copy only data-type members. 



o 
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Example 3 - Using the Copy Commands: The cm command copies a single data set from 
the source volume to the target volume. For example: 



COMMAND{?): CM 

SOURCE (FROM) MEMBER NAME: CALCSRC 

TARGET (TO) MEMBER NAME 

(ENTER * FOR SAME NAME AS SOURCE MEMBER) 



MIGCHRC - MEMBER CALCSRC COPIED. 



33 BLOCKS PROCESSED 



Like all SMIGCOPY copy commands, the CM command automatically allocates the target data set. 
If a data set of the same name already exists on the target volume, it will be deleted before the 
allocation takes place. 

The CALL command copies all data-type data sets from the source volume to the target volume. 
The data sets will have the same names on the target that they had on the source. For example: 



COMMAND(?): CALL 
MIGCHRC - MEMBER $SMMLOG COPIED. 
MIGCHRC - MEMBER $SMMPRIM COPIED. 
MIGCHRC - MEMBER $SMM0203 COPIED. 
MIGCHRC - MEMBER $SMP01 COPIED. 



^v.. 



2 BLOCKS PROCESSED 
2 BLOCKS PROCESSED 
k BLOCKS PROCESSED 
8 BLOCKS PROCESSED 



The CG and CNG commands, like the call command, copies multiple data sets with a single 
command, but they each have an additional parameter, the "generic text" that allows selective 
copying. Before each data set is copied, its name is compared with the generic text you supply. 
If the name begins with the same characters as the generic text, the CG command copies that 
data set. The CNG command works in just the opposite way. If the name does not match the 
generic text, the data set will be copied. 

For example, to copy all data sets whose name begins with the characters "$4": 



COMMAND(?): CG 5^4 

MIGCHRC - MEMBER $A978lS0 COPIED. 

MIGCHRC - MEMBER $A978CS0 COPIED. 

MIGCHRC - MEMBER $'4978CS1 COPIED. 

MIGCHRC - MEMBER $4978lSl COPIED. 



8 BLOCKS PROCESSED 

16 BLOCKS PROCESSED 

16 BLOCKS PROCESSED 

8 BLOCKS PROCESSED 
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The following example copies all data sets whose names do not begin with the character "$": 



COMMAND(?): CNG $ 




MIGCHRC - MEMBER CALCSRC COPIED. 


33 BLOCKS PROCESSED 



Only one data set is copied - calcsrc. 

Example 4 - Controlling Prompting: Besides the ability to selectively copy using generic 
text match, the commands SQ and nq allow you to turn on or off a mode in which you are 
prompted before each data set is copied. At that time you tell $migcopy whether or not to copy 
that particular data set. The SQ command turns the mode on; the NQ command turns if off. If 
on, it is effective for all multiple data set copy commands: 



COMMAND(?): SQ 






COMMAND(?): CG $ 






RESTORE $SMMLOG ? (Y/N) 


N 




RESTORE $SMMPRIM? (Y/N) 


N 




RESTORE $SMM0203? (Y/N) 


N 




RESTORE $SMP01 ? (Y/N) 


Y 




MIGCHRC - MEMBER $SMP01 


COPIED. 


8 BLOCKS PROCESSED 


RESTORE $SMM02 ? (Y/N) 


Y 




MIGCHRC - MEMBER $SMP02 


COPIED. 


6 BLOCKS PROCESSED 


RESTORE SSMMOZOl? (Y/N) 


N 




RESTORE $SMM0202? (Y/N) 


N 





Example 5 - Using the Change Volume (CV) Command: The cv command allows you 
to change the source and target volume assignments. For example, to change the target volume 
to EDX002: 



COMMAND(?): CV 

MIGCSVI - SOURCE VOLUME IS RECOVR OK? (Y/N) 

MIGCTVI - TARGET VOLUME IS EDX005 OK? (Y/N) 



N EDX002 



o 
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This appendix describes the definition statements used to define to your supervisor the I/O 
devices attached to your Series/ 1 . The following definition statements are used to describe your 
system: 



ADAPTER - Defines a multiline attachment 

BSCLINE - Defines a binary synchronous line 

DISK - Defines direct access storage devices 

EXIODEV - Defines EXIO interface devices 

HOSTCOMM - Defines host communication support 

SENSORIO - Defines sensor i/o devices 

SYSTEM - Defines processor characteristics 

TAPE - Defines tape device 

TERMINAL - Defines terminals 

TIMER - Defines system timer feature 

These statements are used in the system generation process only which is described in Chapter 
5, "Generate a Tailored Operating System" on page IS-77. 

For an explanation of the format and syntax rules for coding definition statements, refer to the 
Language Reference. 
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ADAPTER 

ADAPTER - Define a Multiline Attachment 

ADAPTER defines the following attachments to be supported in your generated system: 

• Multifunction Attachment Feature #1310 (mfa) 

• Printer Attachment - 5200 Series Feature #5640 (alpa) 

• Multidrop Work Station Attachment Feature #1250 (SMIO) 

One ADAPTER statement is required for each attachment. All ADAPTER statements must be 
grouped together and must precede the definition of the first device attached to a specific 
attachment. The last adapter statement specified must include an end=yes specification. 

For the Multifunction Attachment (MFA), each ADAPTER statement provides the attachment 
base address (the lowest device address in the attachment's range of up to four device 
addresses) and the names of the devices attached to the system through the attachment. 

For the Printer Attachment - 5200 Series (alpa), each ADAPTER statement provides the 
attachment base address (the lowest device address in the attachment's range of up to eight 
device addresses) and the names of the devices attached to the system through the attachment. 
You can attach up to eight printers through the alpa attachment. 

For the Multidrop Work Station Attachment (SMio), each adapter statement provides the 

attachment base address (the lowest address in the attachment's range of up to eight device 

addresses) and the names of the devices attached to the system through the attachment. You ^~. 

can attach up to eight 4980 display stations through the SMio attachment. ( j 

Notes: 

1 . Each device to be connected through the MFA should be defined exclusively with either the 
TERMINAL and BSCLINE Statements or the EXIODEV statement. A combination of 
system-supported and user-supported devices connected through a common attachment may 
produce unpredictable results. 

2. Each device you are connecting through the ALPA and SMIO attachments must be defined by 
a separate terminal statement. 

3. Modem support for mfa (1310) is half -duplex only. 
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ADAPTER - Define a Muitiiine Attachment (continued) 

Syntax: 



label ADAPTER ADDRESS= TYPE= DEVICES=(list),END= 

Required: label,ADDRESS= TYPE= DEVICES= 

Default: END=NO 



Operand Description 

label A 1 to 8 alphanumeric character label beginning with a letter or one of the 

following special characters: $, #, or (a). Required for each ADAPTER statement. 

ADDRESS= The base address (two hexadecimal digits) of the attachment. For the MFA, this 
address must be divisible by four. For the ALPA and SMIO, this address must be 
divisible by eight. 

TYPE= One of the following: 

MFA Defines the Multifunction Attachment (#1310) 
ALPA Defines the Printer Attachment - 5200 Series (#5640) 
SMIO Defines the Multidrop Work Station Attachment (#1250). 

DEVICES= A list of one to eight labels depending on the type of of attachment: 

• For an MFA, a list of one to four labels on the BSCLINE and TERMINAL 
statements that define the devices attached to the attachment. 

• For an ALPA attachment, a list of one to eight labels on the terminal 
statement that defines the devices attached to the attachment. 

• For an SMIO attachment, a list of one to eight labels on the TERMINAL 
statement that defines the devices attached to the attachment. 

END= YES, for the last adapter statement in the system definition module. The 

default is end=no. 
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ADAPTER - Define a Multiline Attachment (continued) 



Example 1: A Multifunction Attachment with four devices attached: 

• One BSCLINE at address 58 

• Two 3101 Model 23s in block mode at addresses 59 and 5A 

• One 4975-02L printer at address 5B 



MFAO 1 ADAPTER ADDRESS=58 , TYPE=MFA , 

DEVICES=(BSC1 ,$SYSLOG,$SYSLOGA,$SYSPRTR) , END=YES 

BSC1 BSCLINE ADDRESS=58 , ADAPTER=MFA,END=YES 

$SYSLOG TERMINAL DEVICE=ACCA , ADAPTER=MFA, ADDRESS=59 , 
M0DE=3 1 1 B , LMODE=RS422 

$SYSLOGA TERMINAL DEVICE=ACCA, ADAPTER=MFA, ADDRESS=5A, 
M0DE=3 1 1 B , LMODE=RS422 

$SYSPRTR TERMINAL DEVICE=4975-02L, ADAPTER=MFA, ADDRESS=5B, 
END=YES 



Example 2: A Printer Attachment - 5200 Series (ALP A) at address 58 with two devices 
attached. 

• One 5219 printer at address 58 

• One 5219 printer at address 59 

Note: In this example, the address of the attachment and the first device are the same. This is 
vaUd. 



ALPA01 ADAPTER ADDRESS=58 , TYPE=ALPA, 

DEVICES= ( $SYSLOG , $SYSLOGA) , END=YES 

$SYSLOG TERMINAL DEVICE=52 1 9 , ADAPTER=ALPA, ADDRESS=58, 
SECADDR=01 ,PORT=0 

$SYSLOGA TERMINAL DEVICE=521 9 , ADAPTER=ALPA, ADDRESS=59 , 
SECADDR=02 , PORT=0 






O 
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ADAPTER - Define a Multiline Attachment (continued) 






Example 3: A Multidrop Work Station Attachment (SMio) at address 80 with two devices 
attached. 

• One 4980 display station at address 80 

• One 4980 display station at address 81 

Note: In this example, the address of the attachment and the first device are the same. This is 
valid. 



SMIO01 


ADAPTER ADDRESS=80,TYPE=SMIO, 

DEVICES=(TERM1 , TERM2 ) , END=YES 


C 


TERM1 


TERMINAL DEVICE=4980 , ADAPTER=SMIO , ADDRESS=80 , 
SECADDR=01 ,PORT=0 


C 


TERM2 


TERMINAL DEVICE=4980 , ADAPTER=SMIO , ADDRESS=8 1 , 
SECADDR=02 , PORT=0 


C 
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BSCLINE - Define a Binary Synchronous Line 



BSCLINE defines a binary synchronous line to be supported in the generated system. One 
BSCLINE statement is required for each Une to be referenced by programs using the Binary 
Synchronous Communications Access Method. (Refer to the Communications Guide for a 
description of the Binary Synchronous Communications Access Method.) 

Notes: 

1. Code a BSCLINE statement if you use the Remote Management Utility or the X.21 Circuit 
Switched Network support. 

2. Group all BSCLINE statements together with the last BSCLINE statement, including an 
END=yes specification. 

Syntax: 



label 



Required: 
Defaults: 



BSCLINE ADDRESS=TYPE=RETRIES=I\/IC=ADAPTER= 
POLL=(list),END= 

labelif ADAPTER=MFA 
ADDRESS=09,TYPE=PT,RETRIES=6,MC=NO,END=NO 



Operand Description 

label A 1 to 8 alphanumeric character label beginning with a letter or one of the 

following special characters: $, #, or @. 



%^j^ 



Optional unless ADAPTER=MFA. If adapter=mfa, this label must correspond to 
the label in the DEVICE= list on the adapter definition statement. 

ADDRESS= The hardware address (in hexadecimal) of the line. The default is address=09. 
For the X21 Circuit Switched Network support, you must specify an even 
address. 

TYPE= PT (the default) — The line is a point-to-point, nons witched line with a single 

remote station. The adapter should be jumpered with DTR permanently enabled. 
The MFA does not have the DTR jumper. 

Note: Do not use the PT option with the X.21 Circuit Switched Network. 



.J 
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BSCLINE 

BSCLINE - Define a Binary Synchronous Line (continued) 

AC (auto-call) — The line is a point-to-point, switched line. The IBM 2080 
Synchronous Communication Single-Line Control/High Speed Feature should 
be jumpered for switched line operation and binary synchronous 
communications. Auto call is established through the EDX X.21 support. For 
information on using the auto-call option, see the Communications Guide. 

DC (direct-call) — The line is predefined direct on a point-to-point, switched 
line. The IBM 2080 Synchronous Communication Single-Line Control/High 
Speed Feature should be jumpered for switched Une operation and binary 
synchronous communications. Direct call is established through the EDX X.21 
support. For information on using the direct-call option, see the Communications 
Guide. 

SM — The line is on a switched network and connection will be estabUshed 
manually by the operator. The adapter should be jumpered for switched Une 
operation and DTR should not be permanently enabled. The mfa does not have 
the switched line operation and DTR jumpers. 

Note: If you use the SM option with the X.21 Circuit Switched Network, it 
defaults to auto call. 

SA — The line is on a switched network and calls should be answered 
automatically by the BSC Access Method (during BSCOPEN). The adapter should 
be jumpered for switched line operation and DTR should not be permanently 
enabled. The MFA does not have the switched line operation and DTR jumpers. 

Note: If you use the SA option with the X.21 Circuit Switched Network, it 
defaults to auto answer. 

MC — The Series/ 1 is the controlling station on a multipoint line. The adapter 
should be jumpered with DTR permanently enabled and multipoint line should 
not be jumpered. The MFA does not have the dtr and multipoint hne jumpers. 

Note: Do not use the MC option with the X.21 Circuit Switched Network. 
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BSCLINE - Define a Binary Synchronous Line (continued) 



MT — The Series/ 1 is a tributary station on a multipoint line. The adapter 
should be jumpered for multipoint tributary operation with dtr permanently 
enabled. The mfa does have the multipoint tributary operation jumpers; it does 
not have the dtr jumpers. However, the physical jumpers are used only prior to 
initialization time. The logical jumpering and random access memory load 
override the physical jumpering after initialization. 

Note: Do not use the mt option with the X.21 Circuit Switched Network. 

RETRIES= The number of attempts which should be made to recover from common error 
conditions before posting a permanent error. The default is retries =6. 

MC= NO (the default) — The binary synchronous adapter located at the address 

specified in the address = operand is one of the following: a medium speed, 
single-Hne feature card; a high speed, single-Une feature card; an X.21 card 
jumpered to a run as a leased Bisync card; or an mfa (#1310). 

YES — The binary synchronous adapter located at the address specified in the 
ADDRESS= operand is part of a multiline controller feature configuration. When 
generating supervisors using multiline controller attachments, note the following: 

• The character string YES must be specified. Any other character string will 
be equivalent to NO. 

• All multiline feature cards must start at a base address ending with either 
X'O' or X'8'. A BSCLINE statement must exist for the line at this base 
address if any of the other lines of the multiline attachment are to be used. 

Note: Do not use the MC operand with the X.21 Circuit Switched Network. 

ADAPTER = MFA — the Une is on a Multifunction Attachment (MFA) 

Notes: 

1 . If a bisync line is used with the mfa, it must be on the MFA base address. 

2. Do not use the adapter operand with the X.21 Circuit Switched Network. 



o 



\,. 
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BSCLINE - Define a Binary Synchronous Line (continued) 



POLL= A list of 1 to 4 poll/select addresses (two digit hexadecimal) to which the line 

should respond. Applies only if ADAPTER=MFA and TYPE=MT. 

Note: Do not use the POLL operand with the X.21 Circuit Switched Network. 

END= YES, for the last BSCLINE statement in the system definition module. The default 

is END=NO. 



Example 7; A point-to-point, nonswitched binary synchronous line located at address 28 that 
is not part of a multiline controller configuration. 



BSCLINE ADDRESS=28 , TYPE=PT , RETRIES= 1 , MC=NO 



Example 2: A multipoint binary synchronous Une at address 58, attached to a Series/ 1 
through an mfa. A list of three poll/select addresses is specified. 



BSC1 BSCLINE ADDRESS=58 , ADAPTER=MFA,TYPE=MT, POLL= (CO , C1 ,C2) 






Example 3: A binary synchronous line at address 30, on a switched network. An operator 
will establish this line connection manually. 



BSCLINE ADDRESS=30 , TYPE=SM , RETRIES=2 , MC=YES , END=YES 



Example 4: A point-to-point binary synchronous line at address 30, on a switched network. 



BSCLINE ADDRESS=30 , TYPE=AC , RETRIES=2 , END=YES 
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DISK - Define Direct Access Storage 



DISK defines the direct access storage devices to be supported in the generated system. All disk 
statements must be grouped together with the tape statements. The last DISK OR tape 
statement must include an end=yes specification. 

Note: We recommend placing the disk statements that represent disk devices in front of those 
representing diskette devices. This ensures that disks are still accessible if a defective diskette is 
encountered. If you define all your disks before your diskettes, you will get better performance. 

Syntax: 



blank 


DISK DEVICE=,ADDRESS=VOLNAME=(namelist), 




TASK=END= 


Required: 


DEVICE=ADDRESS= 


Defaults: 


END=NO,TASK=NO 



Operand Description 

DEVICE= One of the following device types: 
Type Description 

4964 Diskette Unit 



4964 
4965 



4965 Diskette Unit within the 4952 Model C or 30D processor, the 
4954 or 4956 Model SOD or 60D processors, or the 4965 Storage 
and I/O Expansion Unit 



4966 4966 Diskette Magazine Unit 

4962-1 4962-1 Disk (9.3-megabyte unit) 

4962-lF 4962-lF Disk (9.3-megabyte unit with fixed heads) 

4962-2 4962-2 Disk (9.3-megabyte unit with a diskette unit) 

4962-2F 4962-2F Disk (9.3-megabyte unit with fixed heads and a diskette 
unit) 

4962-3 4962-3 Disk (I3.9-megabyte unit) 

4962-4 4962-4 Disk (13.9-megabyte unit with a diskette unit) 

4963-29 4963-29 Disk (29-megabyte unit) 

4963-23 4963-23 Disk (23-megabyte unit with fixed heads) 



,^'A 
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DISK - Define Direct Access Storage (continued) 

4963-64 4963-64 Disk (64-megabyte unit) 

4963-58 4963-58 Disk (58-megabyte unit with fixed heads) 

4967-2 4967-2 Disk (one or two 200 megabyte units) 

4967-4 4967-4 Disk (one to four 200 megabyte units) 

DDSK-30 30-megabyte Disk within the 4952, 4954, or 4956 Model 30D 

processors or the 4965 storage and I/O expansion unit (model 30D) 

DDSK-60 60-megabyte disk within the 4954 or 4956 Model 60D processors 
or the 4965 storage and I/O expansion unit (model 60D) 

ADDRESS= The hexadecimal address of the unit. 

Notes: 

1. If you have a 4965 diskette unit within the 4952 Model 30D processor,the 
4954 or 4956 Model 30D/60D processors, or within the 4965 storage and 
I/O expansion unit, use a separate DISK statement to define the unit. The 
address of the diskette unit must be one greater than the DDSK-30 or DDSK-60. 
For example, if the disk is defined at address X'44', then the diskette unit 
must be address X'45'. 

2. If you have a 4965 diskette unit, use a separate DISK statement for each 
diskette slot within the unit. The address of the second diskette slot must 
equal the address of the first diskette slot plus 1 . 

VOLNAME= A Ust of volume names (1 to 6 characters) that will be located on the device. 
These volumes are designated as performance volumes. The system finds the 
disk addresses of the specified volumes at IPL time. 

See "Disk Considerations:" on page IS-47 for an explanation of performance 
volumes. 

Each volume you specify requires 46 bytes of storage. 

Notes: 

a. You cannot designate performance volumes on a diskette. As a result, this 
operand is ignored if device=4964, 4965, or 4966. 

b. This parameter is optional; you must allocate the volumes with the $INITDSK 
utility. 

c. Volume names, tape IDS, and terminal statement labels must be unique. 
No tape ID or TERMINAL statement label can match a volume name. 
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DISK- Define Direct Access Storage (continued) 

TASK= NO, or omit, if a new task is not required (the default). An I/O task is 

automatically generated; specify NO to prevent generation of an additional task. 



YES, to cause the system to generate a new I/O task. This task is used to service 
I/O requests for this and subsequent devices until the system encounters a new 
DISK statement with task=yes. 

Specifying task=yes on a disk statement allocates a task control block that is 
used in servicing READ and write requests for the group of devices being 
defined. The effect is to allow READ and WRITE requests to proceed in parallel 
with requests to other groups of devices. With the exception of the 4963 disk, 
the resulting overlap may improve performance significantly when concurrent 
requests to different groups of devices occur. To achieve maximum flexibility 
and performance, you should specify task=yes on each disk statement. Each 
TASK=YES requires 128 bytes of additional storage. 

END= YES, for the last DISK or tape statement in the system definition module. The 

default is end=no. 



Example 1 : One i/O task that is shared by all direct access drives. 



DISK DEVICE=4962-1F,ADDRESS=03 

DISK DEVICE=4963-23,VOLNAME=(EDX002,ASMLIB) ,ADDRESS=48 

DISK DEVICE=4964,ADDRESS=02 

disk DEVICE=4965 , ADDRESS=44 , END=YES 






Note: END=YES is required only once for the DISK/TAPE definition statements. 



Example 2: Each disk has an I/O task. One I/O task for the two 4964s and a second I/O task 
for the 4962. 



DISK DEVICE=4964,ADDRESS=02,TASK=YES 
DISK DEVICE=4964,ADDRESS=12,TASK=YES 
DISK DEVICE=4962- 1 F , ADDRESS=03 , TASK=YES , END=YES 



Example 3: disk definition statement defining the 60-megabyte disk and an optional 4965 
diskette unit. 



DISK DEVICE=DDSK-60,ADDRESS=44 
DISK DEVICE=4965,ADDRESS=45,END=YES 



\J 
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EXIODEV - Define EXIO Interface Device 

EXIODEV defines the devices to be supported via the EXio interface in the generated system. All 
EXIODEV statements must be grouped together. The last exiodev statement must include an 
END=YES specification. 

An EXIODEV statement must be defined for each: 

• System/370 Channel Device attached to your system 

• Physical unit that defines an SDLC line for the Series/ 1 Systems Network Architecture. 

For more information on defining channel attach devices, refer to the Program Directory for the 
Series/ l-System/370 Channel Attach (5719-CXl). For more information on defining an SDLC 
line, refer to the Program Directory for the Series/ 1 Systems Network Architecture 
(5719-SXl). 

Notes: 



^f*\ 



1 . Any device defined via EXIODEV should not be defined on any other statement such as DISK 
or BSCLINE. Doubly-defined devices will cause unpredictable results when accessed by a 
combination of READ/ WRITE and EXIO. The system does not initialize any device you define 
with EXIODEV. You must load any control store that is required by the device. 

2. If you define devices connected through a multiple-device feature (controller), the devices 
should be either defined exclusively with the EXIODEV statement or the TERMINAL or 
BSCLINE statements. A combination of system supported and user supported devices 
connected through a common attachment may produce unpredictable device. 



Syntax: 



blank 



EXIODEV 



ADDRESS= END= MAXDCB= RSB= 



Required: ADDRESS= 

Defaults: MAXDCB=0,RSB=0,END=NO 



Operand Description 

ADDRESS= The device address (two hexadecimal digits). For a system with SNA support, 
this address must match the address specified for the ADDRESS= operand of the 
SNAPU definition statement. 

MAXDCB= The maximum number of chained DCBs which will be used for this device. Must 
be eight or less. The default is MAXDCB=0. 

Note: If the device you define is an OEM or IBM device (nonstandard support), 
refer to the device description manual for that device for MAXDCB count. 



Appendix A. System Definition Statements IS- 157 



EXIODEV 

EXIODEV- Define EXIO Interface Device (continued) 



For a system with SNA support, the value specified must be 2— 8. This value 
must be equal to the value specified on the dcbno= operand on the SNAPU 
definition statement and one greater than the value specified for the MAXOUT 
parameter of the network control program (ncp). 

For a system with one System/370 Channel Attach device, specify maxdcb=2. 

For a system with more than one System/370 Channel Attach device, specify 
MAXDCB=2 on one exiodev statement and maxdcb=1 on the others. 

For a system with a Data Collection Interactive rpq, specify maxdcb= 1 . 

RSB= The number of residual status bytes the device will transfer. Enter zero or an 

even decimal number between 4 and 16 inclusive. The default is RSB=0. 

Note: If the device you define is an OEM or IBM device (nonstandard support), 
refer to the device description manual for that device for rsb count. 

For a system with SNA support, specify RSB =4. 

For a System/370 Channel Attach device, specify RSB=6. 

For a system with a Data Collection Interactive RPQ, specify RSB=4. 

END= Specify YES for the last exiodev statement in the system definition module. The 

default is end=no. 






Examples: 



EXIODEV ADDRESS=00 

EXIODEV ADDRESS=EO , RSB= 1 2 , MAXDCB=2 

EXIODEV ADDRESS=10,RSB=6,MAXDCB=2 

EXIODEV ADDRESS= 1 1 , RSB=6 , MAXDCB= 1 , END=YES 



o 



IS- 158 SC34-0646 



HOSTCOMM 



^jiijiiiii^r 



HOSTCOMM - Define Host Communications Support 



HOSTCOMM defines the device type and address to be used for host communication support in 
the generated system. This support operates with the Host Communications Facility Installed 
User Program (lUP). 

Syntax: 



blank 



HOSTCOMM DEVICE= ADDRESS= 



Required: DEVICE= ADDRESS= 
Defaults: None 






Operand Description 

DEVICE= BSCA, for Binary Synchronous Communications Adapter support. This is the 
only device supported and must be a single line BSC adapter (feature 2074 or 
2075). Only one is allowed. 

ADDRESS = The hexadecimal address of the adapter. 

Example: 



HOSTCOMM DEVICE=BSCA,ADDRESS=09 
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SENSORIO - Define Sensor I/O Devices 



SENSORIO defines the sensor i/o devices to be supported in the generated system. All SENSORIO 
statements must be grouped together with the last one including an end=yes specification. 

Syntax: 



blank 



Required: 
Defaults: 



SENSORIO ADDRESS= DEVICE=AI= AO=DI=DO= PI=AITYPE= 
LEVEL=END= 

DEVICE=ADDRESS= 
AITYPE=RELAY,LEVEL=1,END=N0 



Operand 



Description 



ADDRESS = The base address of the device (in hexadecimal). This is the only required 
address if DEVICE=idio unless pi is needed on this unit. 



DEVICE= 



AI= 

AO= 

DI= 

DO= 

PI= 



One of the following device types: 

IDIO The integrated digital I/O nonisolated feature (feature #1560) 

4982 The sensor I/O unit 

The address or list of addresses of the analog input multiplexor feature(s) on this 
device. 

The address or list of addresses of the analog output point(s) on this device. 

The address or Ust of addresses of the digital input group(s) on this device. 

The address or Ust of addresses of the digital output group(s) on this device, pi 
can be read as Di. 

The address or list of addresses of the digital input group(s) to be used as process 
interrupt. 

Note: For the Ai, AO, Di, DO and Pi operands, multiple addresses must be 
included in parentheses. 
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SENSORIO - Define Sensor I/O Devices (continued) 

AITYPE= The type of Al multiplexer(s). Valid entries are: 

• RR or RELAY - for relay (the default) 

• SS or SOLID - for solid state 



LEVEL= 



Note: The names have a one-to-one relationship with addresses on the Al 
operand. Multiple entries must be included in parentheses. 

A number (from 0-3) to assign the hardware interrupt level to the device. The 
default is LEVEL=1. 



END= 



Note: This assignment is for all features on that device. 

YES, for the last SENSORIO statement in the system definition module. The 
default is end=no. 



Examples: 






SENSORIO DEVICE=IDIO,ADDRESS=68 

SENSORIO DEVICE=4982 , ADDRESS=60 , AO=65 , DO=62 , DI=64 , 
PI=63,AI=61 ,AITYPE=SS 

SENSORIO DEVICE=4982,ADDRESS=70,DI=(70,71 ) 

SENSORIO DEVICE=4982,ADDRESS=60,AI=(62,63) , 

AITYPE= (RELAY, SOLID) , AO=64 , DI= (65 , 66) ,DO=67 

SENSORIO DEVICE^IDIO , ADDRESS=68 , PI=68 , END=YES 
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SYSTEM - Define Processor Storage 



SYSTEM defines the characteristics of the processor storage, including the partition structure, the 
storage assigned to each partition for execution of application programs, and the number of 
programs that can concurrently execute in each partition. This statement must be specified 
once. 



Note: You need only define the number of partitions required for program execution. If you 
generate a multipartition supervisor and place supervisor code in a partition that you have not 
defined on the system statement, the partition is automatically defined. However, this partition 
will only contain supervisor code and cannot be used for execution of application programs. 

The Event Driven Executive supports two types of storage: mapped and unmapped. Mapped 
storage is the storage you define with the part= operand. Unmapped storage is any storage not 
defined with the part= operand or any storage above 512K. The system acquires unmapped 
storage through the unmapped storage instructions. See the Language Reference for a 
description of these instructions. For an explanation of using unmapped storage for application 
programs, see the Event Driven Executive Language Programming Guide. 

Syntax: 



blank 



Required: 
Defaults: 



SYSTEM MAXPROG=,PARTS= DATEFMT=IABUF= 

XPSSTK=,COMMON= INITPRT= INITMOD= MECBLST= 

None 

MAXPROG=10,PARTS=32,DATEFMT=IVIMDDYY 

IABUF=20,XPSSTK=20,COMIVION=EDXSYS 






.y 



Operand 



Description 



MAXPROG= The maximum number of concurrently executing programs to be allowed in a 
partition. Add 1 to your calculated number for each occurrence of $JOBUTlL in 
that partition. Add 2 for each occurrence of the session manager in that 
partition. Four words of storage are required in the nucleus for each program 
specified. The default is MAXPROG=10. 

You must specify a list of the maximum number of concurrently executing 
programs allowed in each partition. The number of programs that can run 
concurrently in a system varies with each installation depending on the size of 
your processor storage and programs and your processor time requirements. 

If your system has unmapped storage, you need to specify a greater number of 
programs because unmapped storage generally uses more storage within a 
partition. For example, if you would normally define five (5) programs, specify 
seven (7) instead. 
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SYSTEM - Define Processor Storage (continued) 

PARTS = The number of 2K (1K= 1024 bytes) blocks of storage to be assigned to each 

partition for execution of appUcation programs. You can specify up to 32 2K 
blocks of storage or up to a total of 64K for each partition. Depending on the 
size of your supervisor, you may not receive the amount of user space anticipated 
because of the amount of storage taken up by supervisor code within a partition. 
Enter a list showing the maximum size of each partition. You can define up to 
eight 64K partitions for the 4955 and 4956, up to four 64K partitions for the 
4954, and up to two 64K partitions for the 4952. The hst must contain the same 
number of entries as the Ust coded for MAXPROG=. The default is PARTS =32. 

The user partitions (1—8) must fit in corresponding address spaces or map areas 
that are respectively numbered 0—7 and can contain 64KB of designated 
storage. 

The amount of storage available in any partition is the smaller of: 

• The size you define in the parts = parameter 

• 64K minus the size of the supervisor. 

(Refer to Chapter 4, "Select Your Required Support" on page IS-39 for 
information on how to estimate supervisor size.) 

The maximum value that can be specified is 32; the minimum is 0. When you 
specify the size to be assigned to partition 1 and you wish partition 1 to have all 
storage not used by the supervisor, code 32 rather than calculating the value. 
Otherwise, you must calculate the size of partition 1 . 

To define unmapped storage, specify less than 32 2K blocks of storage for each 
partition. For example, if you have three partitions in a 192K processor and only 
define PARTS=(32,16,16), you only map 128K of processor storage. The 
balance of 32 2K blocks is unmapped storage. 

(To determine the storage required by licensed programs such as the Indexed 
Access Method and the Multiple Terminal Manager, refer to work sheet 4 in 
Appendix E.) 
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DATEFMT= The format to be used when the date is displayed (prindate or $w) or when 
entering the date via $T. A return code is set in response to a GETTIME request 
with the DATE option. 

Specify mmddyy for a date format of month, day. year. Specify DDMMYY for a 
date format of day. month. year, mmddyy is the default. 



Note: You must include timer support in your supervisor to have date support. 

IABUF= The maximum number of interrupts that may be buffered by the task supervisor. 

You must code a value between 10 and 100. The default is 20 and is adequate 
for most systems. The value should be increased if the system could be 
overloaded by a large number of interrupts. (The system will stop or enter a 
continuous run loop.) Each increment increases the supervisor storage 
requirements by eight bytes. 

Note: Use the $stguti utility (mx command) to monitor the number of 
interrupts buffered by the task supervisor. 

XPSSTK= The size of the cross partition stack in 6-byte entries. This stack contains the 
return address and partition numbers that the supervisor refers to when 
branching between partition one and supervisor portions in other partitions. You 
must code a value between 10 and 128. The default size is 20. This default is 
usually sufficient for your programming needs. 

Note: Use the $STGUT1 utiUty (MX command) to monitor the number of entries 
in the cross partition stack. 

COMMON = A partition 1 supervisor address or the size of the supervisor data area. Code up 
to eight labels or numbers. The labels represent a partition 1 (address space 0) 
supervisor address. The numbers represent the size (in 2K blocks) of a partition 
1 (address space 0) supervisor data area. The valid numbers are to 31. The 
syntax of the COMMON= operand is as follows: 




Whether you specify labels or numbers, you can map the area as common in all 
partitions, in any specific partition, or in no partitions. The syntax of the 
operand is such that each entry (a maximum of eight) corresponds to address 
spaces through 7. If you do not want to map the common area into a specific 
partition, code the COMMON= operand as in the following example where the 
supervisor data areas are mapped into partitions 2, 3, and 5. 






\_J^ 
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SYSTEM - Define Processor Storage (continued) 




The size of the common area will be rounded upward automatically to a 2K byte 
boundary. 

To map the entire resident supervisor, specify COMMON=EDXSTART. To map 
only the supervisor data areas, specify COMMON=EDXSVCX. The default, 
COMMON=EDXSYS, implies no mapping. 

INITPRT= The partition into which $INITIAL is loaded after system initiaUzation. If you 
specify a partition and there is not enough storage in that partition to contain 
$INITIAL, the system cannot load it and issues a LOAD instruction return code of 
70. If you do not specify a partition number and allow INITPRT to default, the 
system attempts to load $initial into the first partition it finds with enough 
storage to contain $INITIAL. 



^ 



^ 



INITMOD= A list of entry point names in modules to be executed during system 

initialization. The modules must be link edited with the supervisor and may not 
execute load instructions. Each module must return to the entry point INITEXIT. 
Each module must begin execution in Event Driven Language. Control is passed 
to the module using a GOTO instruction. 

MECBLST= The maximum number (in decimal) of event control blocks (ECBs) allowed in 
the system at any given time. The MECB statement is used in conjunction with 
the WAITM instruction to permit a program to wait on the occurrence of multiple 
events. You can specify from 1 to 64 ECBs. The system generates an ECB 
pointer consisting of two words (address and address key). For example, if you 
specify 64, the system generates 128 words. 
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Example 1: Define a three-partition system on a 96K-byte 4955. 



SYSTEM MAXPROG= (3,2,3), PARTS= (32,6,10) 



The system logically and physically maps in storage as follows: 
Logical mapping: 



Address space 
Address space 1 
Address space 2 



28KB supervisor 


36KB user space (partition 1) 


12KB user space (partition 2) 


Invalid 


20KB user space (partition 3) 


Invalid 



Physical mapping: 



64KB 


12KB 


20KB 1 



1. Partition 1 requires 14 blocks (28KB) for the supervisor and has 18 blocks (36KB) left for 
user space. Partition 1 can execute up to three programs concurrently. 

Partition 1 is defined as 9 blocks (18KB) of storage. The supervisor required 14 blocks 
(28KB) and the initialization routines required 9 blocks (18KB) of storage at IPL time. 
After initialization, the 9 blocks of storage required by the initialization routines were given 
back as user space. 

2. Partition 2 requires 6 blocks (12KB) of storage for user space. Partition 2 can execute up to 
two programs concurrently. 

3. Partition 3 requires 10 blocks (20KB) of storage for user space. Partition 3 can execute up 
to three program concurrently. 

4. There is no unmapped storage. 

Note: The 28KB supervisor size is used for illustrative purposes only. 



^kiK*-^ 
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SYSTEM - Define Processor Storage (continued) 



Example 2: Define a single-partition (64K) system. 



SYSTEM MAXPR0G=5 



The system logically and physically maps in storage as follows: 
Logical mapping: 

Address space 



28KB supervisor 



36KB user space (partition II 



Physical mapping: 



64KB 






The supervisor requires 14 blocks (28KB) for the supervisor and has 18 blocks (36KB) left for 
user space. Up to five programs can execute concurrently. 

Note: The 28KB supervisor size is used for illustrative purposes only. 
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Example 3: Define a six-partition system on a 196K-byte 4955. 



SYSTEM MAXPROG= (1,2,1,3,4,1), 

PARTS=(9, 12,7,4,20,23) , INITPRT=2 



The system logically and physically maps in storage as follows: 
Logical mapping: 



Address space 
Address space 1 
Address space 2 
Address space 3 
Address space 4 
Address space 5 



28KB supervisor 



36KB user space (partition 1i 



24KB user space (partition 2) 



14KB user space (partition 3) 



8KB user space (partition 4) 



40KB user space (partition 5) 



46KB user space (partition 6) 



Invalid 



Invalid 



Invalid 



Invalid 



Invalid 



Physical mapping: 



64KB 



46KB 



24KB 



14KB 



8KB 



40KB 
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SYSTEM - Define Processor Storage (continued) 

1. Partition 1 requires 14 blocks (28KB) for the supervisor and has 18 blocks (36KB) left for 
user space. Partition 1 can execute one program at a time. 

Partition 1 is defined as 9 blocks (18KB) of storage. The supervisor required 14 blocks 
(28KB) and the initialization routines required 9 blocks (18KB) of storage at IPL time. 
After initialization, the 9 blocks of storage required by the initialization routines were given 
back as user space. 

2. Partition 2 requires 12 blocks (24KB) of storage and can execute up to two program 
concurrently. 

3. Partition 3 requires 7 blocks (14KB) of storage and can execute one program at a time. 

4. Partition 4 requires 4 blocks (8KB) of storage and can execute up to three programs 
concurrently. 

5. Partition 5 requires 20 blocks (40KB) of storage and can execute up to four programs 
concurrently. 

6. Partition 6 requires 23 blocks (46KB) of storage and can execute one program at a time. 

7. $INITIAL, if it exists, will be loaded into partition 2 if there is enough space. 
Note: The 28KB supervisor size is used for illustrative purposes only. 
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Example 4: Define a three-partition system on a 128K-byte 4955. 



SYSTEM MAXPROG=(10, 10, 10) , 

PARTS= (27,9,23) , INITMOD= (CSXINIT) 



The system logically and physically maps as follows: 
Logical mapping: 

Address space 
Address space 1 
Address space 2 



28KB supervisor 


36KB user space (partition 1) 


18KB user space (partition 2) 


Invalid 


46KB user space (partition 3) 


Invalid 



Physical mapping: 



64KB 


18KB 


46KB 



1. Partition 1 requires 14 blocks (28KB) for the supervisor and has 18 blocks (36KB) left for 
user space. Partition 1 can execute one program at a time. 

Partition 1 is defined as 27 blocks (54KB) of storage. The supervisor required 14 blocks 
(28KB) and the initialization routines required 9 blocks (18KB) of storage at IPL time. 
After initiaUzation, the 9 blocks of storage required by the initialization routines were given 
back as user space. Although partition 1 was defined as 54KB of user space, the supervisor 
required 28KB of storage leaving only 36KB of available user space. 

2. Partition 2 requires 9 blocks (18KB) of storage and can execute up to 10 programs 
concurrently. 

3. Partition 3 requires 23 blocks (46KB) of storage and can execute up to 10 programs 
concurrently. 

4. The module with entry point name of CSXINIT will be activated during initialization. 
Note: The 28KB supervisor size is used for illustrative purposes only. 






IS- 170 SC34-0646 



o 



SYSTEM - Define Processor Storage (continued) 



Example 5: Define a two-partition system on a 128K-byte 4952. 



SYSTEM MAXPROG= (3,6) , PARTS= (32,32), 
COMMON=EDXSVCX , DATEFMT=MMDDYY 



SYSTEM 



The system logically and physically maps as follows: 
Logical mapping: 



Address 
space 



Address 
space 1 



4KB control 
block 

4KB control 
block 


28KB supervisor 


32KB space 
(partition 1) 


60KB user space 
(partition 2) 


4KB 
unmapped 



Physical mapping: 



64KB 


60KB 


4KB 



1. Partition 1 is 32KB and can execute up to three programs concurrently. 

2. Partition 2 is 60KB and can execute up to six programs concurrently. The programs all have 
direct addressability to supervisor control blocks (for example, the CVT (communications 
vector table) and DVT (device vector table) because of the common=edxsvcx parameter. 

3. Total storage used: 4KB + 28KB + 32KB + 60KB = 124KB. The size of process storage 
is 128KB leaving 4KB of unmapped storage. 

Note: The 28KB supervisor size and the 4KB control block size are used for illustrative 
purposes only. 
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Example 6: Define a two-partition system on a 128K-byte 4952. 



SYSTEM MAXPROG= (4,4), PARTS= (32,32), 
DATEFMT=MMDDYY 



The system logically and physically maps as follows: 
Logical mapping: 



Address space 
Address space 1 



30KB supervisor 



34KB user space (partition 1! 



64KB user space (partition 2) 



Physical mapping: 



1 64KB 


64KB 



1. Partition I requires 15 blocks (30KB) of storage for the supervisor and has 17 blocks 
(34KB) of storage left for user space. Partition 1 can execute up to four programs 
concurrently. 

2. Partition 2 requires 32 blocks (64KB) of storage and can execute up to four programs 
concurrently. 

3. When the date is displayed, it will be in month, day, and year format. 
Note: The 30KB supervisor size is used for illustrative purposes only. 
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SYSTEM - Define Processor Storage (continued) 

Example 7: Define an eight-partition system on a 256K-byte 4955. 






SYSTEM MAXPR0G=(3, 1 ,5,2,2, 1 , 1 ,4) , 
PARTS=(15,4,21 ,13,17, 11 ,8,23) 



The system logically and physically maps as follows: 
Logical mapping: 



Address 
space 


32KB 


supervisor 




30KB 


user space (partition 1) 


Invalid 


Address 
space 1 


8KB user space (partition 2) 


Invalid 


Address 
space 2 


42KB 


user space 


(partition 3) 




Invalid 


Address 
space 3 


26KB 


user space 


(partition 4) 




Invalid 


Address 
space 4 


34KB 


user space 


(partition 5) 




Invalid 


Address 
space 5 


22KB 


user space 


(partition 6) 




Invalid 


Address 
space 6 


16KB 


user space 


(partition 7) 




Invalid 


Address 
space 7 


46KB 


user space 


(partition 8) 




Invalid 
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Physical mapping: 



62KB 


8KB 


42KB 


26KB 1 


34KB 


22KB 


16KB 


46 KB 1 



1. Partition 1 requires 16 blocks (32KB) of storage for the supervisor and has 15 blocks 
(30KB) of storage left for user space. Partition 1 can execute up to three programs 
concurrently. 

2. Partition 2 requires 4 blocks (8KB) of storage for user space and can execute one program 
at a time. 

3. Partition 3 requires 21 blocks (42KB) of storage for user space and can execute up to five 
programs concurrently. 

4. Partition 4 requires 13 blocks (26KB) of storage for user space and can execute up to two 
programs concurrently. 



concurrently. 

5. Partition 5 requires 17 blocks (34KB) of storage for 
programs concurrently. 

6. Partition 6 requires 1 1 blocks (22KB) of storage for 
program at a time. 



user space and can execute up to two 
user space and can execute one 



7. Partition 7 requires 8 blocks (16KB) of storage for user space and can execute one program 
at a time. 

user space and can execute up to four 



Partition 8 requires 23 blocks (46KB) of storage for 
programs concurrently. 



Note: The 32KB supervisor size is used for illustrative purposes only. 
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SYSTEM - Define Processor Storage {continued) 



Example 8: Define a two-partition system on a 96K-byte 4952. 



SYSTEM MAXPROG= (3,4), PARTS= (16,18), 
COMMON=EDXSTART 



The system logically and physically maps as follows: 
Logical mapping: 



Address 
space 



Address 
space 1 



SYSTEM 



28KB supervisor 
28KB supervisor 


32KB user space 
(partition 1) 


Invalid 


36KB user space (partition 2) 



Physical mapping: 



60KB 


36KB 



1. Because C0MM0N=EDXSTART was specified, the supervisor is mapped in both partition 1 
and partition 2, providing direct addressabiUty to the supervisor for all programs that 
execute on this system. 

2. Partition 1 requires 14 blocks (28KB) of storage for the supervisor and has 16 blocks 
(32KB) of storage left for user space. Partition 1 can execute up to three programs 
concurrently. 

3. Partition 2 requires 14 blocks (28KB) of storage for the supervisor and has 18 blocks 
(36KB) of storage left for user space. Partition 2 can execute up to four programs 
concurrently. 

4. Total storage used: 28KB + 32KB + 36KB = 96KB 

Note: The 28KB supervisor size is used for illustrative purposes only. 
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Example 9: Define a five-partition system on a 256-byte 4955. 



SYSTEM MAXPROG= (10,10,10,10,10), 

PARTS= (26,26,26,26,26), COMMON=USRMAP 



The supervisor requires 42K bytes of storage and the COMMON area requires 12K bytes of 
storage. The system logically and physically maps as follows: 

Logical mapping: 



Address 
space 

Address 
space 1 

Address 
space 2 

Address 
space 3 

Address 
space 4 



42KB supervisor 


22KB user space 
(partition 1) 


12KB 

common 


52KB user space (partition 2) 


12KB 
common 


52KB user space (partition 3) 


12KB 
common 


52KB user space (partition 4) 


12KB 
common 


52KB user space (partition 5) 



^_J/ 



Physical mapping: 



64KB 



52KB 



52KB 



52KB 



36KB 



1. Partition 1 requires 21 blocks (42KB) for the supervisor and has 1 1 blocks (22KB) left for 
user space. Partition 1 can execute up to 10 programs concurrently. 

2. Partition 2 requires 6 blocks (12KB) to serve as addressing pointers to the common area 
and has 26 blocks (52KB of actual storage mapped for user space. The 6 blocks of pointers 
cannot map actual storage since they are reserved as COMMON area pointers. Partition 2 can 
execute up to 10 programs concurrently. 

3. Partitions 3 and 4 are the same as Partition 2. 

4. Partition 5 maps all of the actual storage not previously mapped. The six 2KB blocks of 
storage from partitions 2, 3, and 4 equal 36KB mapped into the last partition. Partition 5 
can execute up to 10 programs concurrently. 



o 
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Example 10: Define a five-partition system on a 512-byte 4956. A multipartition supervisor 
was generated for this system with 24K of supervisor code in partition 1, 14K in partition 3, and 
13K in partition 8. 



SYSTEM MAXPR0G=(1 ,5,5,5,5) ,PARTS=(32,32, 32, 16,32) C 
COMMON= (0,8,10) 






The system logically and physically maps as follows: 
Logical mapping: 



Address 
space 

Address 
space 1 

Address 
space 2 

Address 
space 3 

Address 
space 4 

Address 
space 5 

Address 
space 6 

Address 
space 7 



24KB supervisor 



16KB common 



40KB user space (partition 1) 



48KB user space (partition 2) 



20KB common 



14KB 
supervisor 



32KB user space (partition 4) 



30KB user space 
(partition 3) 



Invalid 



64KB user space (partition 5) 



Invalid 



Invalid 



13KB 
supervisor 



1KB user 
space 



Invalid 



246KB unmapped storage 
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Physical mapping: 



64KB 


48 KB 


44KB 


32KB 1 


64KB 


14KB 


246KB unmapped 



1. Partition 1 requires 12 blocks (24KB) for the supervisor and has 20 blocks (40KB) left for 
user space. Partition 1 can execute up to 10 programs concurrently. 



2. Partition 2 requires 8 blocks (16KB) to serve as addressing pointers to the COMMON area 
and has 24 blocks (48KB) of actual storage mapped for user space. The 8 blocks of 
pointers cannot map actual storage since they are reserved as COMMON area pointers. 
Partition 2 can execute up to 10 programs concurrently. 

3. Partition 3 requires 10 blocks (20KB) to serve as addressing pointers to the COMMON area 
and has 7 blocks (14KB) for the supervisor and 15 blocks (30KB) left for user space even 
though the user requested 64KB of user space. Partition 3 can execute up to 10 programs 
concurrently. 

4. Partition 4 requires 16 blocks (32KB) of storage for user space. 

5. Partition 5 is not defined. 

6. Partition 6 is not defined. 

7. Partition 7 was not defined on the SYSTEM statement, however, a multipartition supervisor 
was defined with the part= statement in the $lnkcntl data set as having 13KB of 
supervisor code in partition 8. As a result, partition 8 was automatically defined and 13KB 
of storage was assigned to the supervisor. In addition, because storage is assigned in 2K 
blocks, 1KB of storage is assigned as user space for a total of 14KB in partition 8. 

8. The size of process storage is 512KB. Only 266KB of storage was defined leaving 246KB 
of unmapped storage. 



c 
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SYSTEM - Define Processor Storage (continued) 

Example 71: Define a three-partition system on a 512-byte 4956. A multipartition supervisor 
was generated for this system with 5 OK of supervisor code in partition 1, 17K in partition 6, and 
15K in partition 8. 



SYSTEM MAXPROG= (1,10,1) , PARTS= (2,16,16) , 
COMMON= ( , LABEL , 8 ) 



In this example, LABEL is at address X'8000' of the supervisor in partition 1. 
The system logically and physically maps as follows: 
Logical mapping: 



Address 
space 

Address 
space 1 

Address 
space 2 

Address 
space 3 

Address 
space 4 

Address 
space 5 

Address 
space 6 

Address 
space 7 



40KB supervisor 



14KB user space 
(partition 1) 



32KB common 



16KB common 



Invalid 



32KB user space 
(partition 2) 



32KB user space 
(partition 3) 



Invalid (partition 4) 



Invalid (partition 5) 



17KB supervisor 



1KB user space 
(partition 6) 



Invalid (partition 7) 



15KB supervisor 



1KB user space 
(partition 8) 



360KB unmapped storage 



Invalid 



Invalid 



Invalid 



Physical mapping: 



54KB 



32KB 



32KB 



18KB 



16KB 360KB unmapped 
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1. Partition 1 requires 20 blocks (40KB) for the supervisor and has 7 blocks (14KB) left for 
user space. Partition 1 can execute one program. After initialization, the 5 blocks (10KB) 
of storage required by the initialization routines were given back as user space. 

2. Partition 2 requires 16 blocks (32KB) to serve as addressing pointers to the COMMON area 
and has 16 blocks (32KB) of actual storage mapped for user space. The 16 blocks of 
pointers cannot map actual storage since they are reserved as common area pointers. 
Partition 2 can execute up to 10 programs concurrently. 

3. Partition 3 requires 8 blocks (16KB) to serve as addressing pointers to the COMMON area 
and has 16 blocks (32KB) for the supervisor and 15 blocks (30KB) for user space. 
Partition 3 can execute up to 10 programs concurrently. 

4. Partition 4 is not defined. 

5. Partition 5 is not defined. 

6. Partition 6 was not defined on the system statement, however, a multipartition supervisor 
was defined with the part= statement in the $lnkcntl data set as having 17KB of 
supervisor code in partition 6. As a result, partition 6 was automatically defined and 17KB 
of storage was assigned to the supervisor. In addition, because storage is assigned in 2K 
blocks, 1KB of storage is assigned as user space for a total of 18KB in partition 6. 

7. Partition 7 is not defined. 

8. Partition 8 was not defined on the system statement, however, a multipartition supervisor 
was defined with the PART= statement in the $lnkcntl data set as having 15KB of 
supervisor code in partition 8. As a result, partition 8 was automatically defined and 15KB 
of storage was assigned to the supervisor. In addition, because storage is assigned in 2K 
blocks, 1KB of storage is assigned as user space for a total of 16KB in partition 8. 

9. The size of process storage is 512KB. Only 152KB of storage was defined leaving 360KB 
of unmapped storage. 
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TAPE - Define Tape Device 



TAPE defines tape devices. One TAPE statement is required for each tape device on the system. 
Group all disk and tape statements together. The last tape or disk statement must specify 

END=YES. 

Syntax: 



blank 



Required: 
Defaults: 



TAPEDEVICE=ADDRESS=,DENSITY=LABEL= ID= 
TASK= END= 

DEVICE= ADDRESS= ID= 
DENSITY=1600,LABEL=SL,TASK=NO,END=NO 



Operand Description 

DEVICE= Required if 4968; otherwise, defaults to 4969. 

4968 4968 tape unit 

4969 4969 tape unit 

ADDRESS= A two-digit hexadecimal number specifying the address assigned to the unit. 

DENSITY= Tape density to be used for this device. 

For the 4968 tape unit, the valid densities are 1600, 3200, and DUAL. When 
DUAL is coded, density defaults to 1600 BPI. 

For the 4969 tape unit, the valid densities are 800, 1600, and DUAL. When 
DUAL is coded, density defaults to 1600 BPI. 

Note: A 4968 density selection of 3200 BPI is not ANSI standard and is only 
compatible with other 4968 tape units. 

LABEL= Type of processing to be done on this device. Standard label (sl), nonlabel 

(nl), and bypass label processing (blp) are the only types supported. The 
default is label=sl. 
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ID= 



TASK= 



END= 



A one- to six-character name that is associated with the device. This operand is 
used primarily for specifying the drive when NL or blp is used. 

Note: Tape ids, volume names (see the DISK definition statement), and the 
labels associated with terminal definition statements must be unique. No 
volume name or terminal definition statement label can match a tape ID. 

YES, causes a new I/O task to be generated. This task is used to service I/O 
request for this and subsequent tapes until a new tape statement with TASK=YES 
is encountered. For best performance, specify task=yes for each tape unit that 
has a controller. The default is task=no; one task is received. 

Additional storage required for each task=yes is 128 bytes. 

YES, for the last statement in the disk/tape sequence. The default is end=no. 



Example: Define a 4969 tape unit at address 4C. The tape is a standard label tape set at a 
density of 1600. The name associated with the tape unit is $tapel 



TAPE DEVICE=4969,ADDRESS=4C,DENSITY=1600,LABEL=SL, C 
ID=$TAPE1 ,TASK=YES,END=YES 



Note: END=YES is required only once for the disk and tape definition statements. 
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TERMINAL- Define Input/Output Terminals 



TERMINAL defines each EDX terminal to be supported in the generated system. It is coded in 
your source statements for system generation, and is assembled with DISK, SYSTEM, and other 
supervisor definition statements. The DEVICE= operand of the TERMINAL statement identifies 
the type of terminal. 



.^ 



EDX terminals include a wide variety of devices such as keyboard/displays, printers, other 
processors, plotters and lab equipment. The operands of the terminal statement define many 
of the characteristics of a particular terminal. The first operand usually coded is DEVICE= and 
its value determines which operands to code and their values. One such operand whose 
inclusion and value depends upon the value of the device operand is the CODTYPE operand. 
The devices supported and the feature code used to connect the device to the Series/ 1 are 
shown in Figure 12 . 



Terminal 


Feature 
number 


DEVICE 
operand 
of 
TERMINAL 


CODTYPE 
operand 


IBM 3101 Display Terminal, all 
models 


#1310, #2095 
with #2096, 2095 
with RPQ D02350 


ACCA 


ASCII 


IBM 3101 Display Terminal, all 
models 


#1610, #2091 
with #2092 


ACCA 


EBASC 


IBM 3101 Display Terminal, models 
10, 12, and 13 


#7850 


TTY3 


ASCII 


IBM 4978 Display Station 


RPQ D02038 


4978 


N/A 


IBM 4979 Display Station 


#3585 


4979 


N/A 


IBM 4980 Display Station 


#1250 


4980 


N/A 


Teletype3 ASR 33/35 (TTY) or 
equivalent 


#7850 


TTY 


ASCII 


ASCII Terminal 


#2095 with 
#2096 


ACCA 


ASCII 


ASCII Terminal 


#1610, #2091 
with #2092 


ACCA 


EBASC 


IBM 2741 Communication Terminal 


#1610 


2741 


CRSPorEBCD 


IBM 4973 Line Printer 


#5630 


4973 


N/A 



J 



Figure 12 (Part 1 of 2). Supported EDX terminals and DEVICE/CODTYPE operands 



Trademark of Teletype Corporation 
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Terminal 


Feature 
number 


DEVICE 
operand 
of 
TERMINAL 


CODTYPE 
operand 


IBM 4974 Matrix Printer 


#5620 


4974 


N/A 


IBM 4975 Printer (all nnodels except 
01 A) 


#1310 


4975-01 R 
4975-01 L 
4975-02R 
4975-02L 


N/A 


IBM 4975-01 A Printer 


#1310 or #2095 
with 2096 


ACCA 


ASCII 


IBM 5219 Line Printer 


#5640 


5219 


N/A 


IBM 5224 Matrix Printer 


#5640 


5224 


N/A 


IBM 5225 Matrix Printer 


#5640 


5225 


N/A 


IBM Series/1 


#1610, RPQs 
D02241 and 
D02242 


PROC 


N/A 


General Purpose Interface Bus (GPIB) 


RPQD02118 


GPIB 


ASCII 


Textronics 40xx Graphics Terminal 


#1560 


4013 


ASCII 






/f" 



Figure 12 (Part 2 of 2). Supported EDX terminals and DEVICE/CODTYPE operands 



k.y 



ASCII Transmission Codes 



Terminals and other devices equivalent to the Teletype ASR 33/35 are referred to as ASCII 
terminals. Depending upon the feature number used to connect these terminals to the Series/ 1, 
the transmission code is either ASCII or EBASC (mirror image ASCII). The CODTYPE operand 
specifies the transmission code to be used by the terminal and defines the internal representation 
of characters. (See Communications Guide for a list of transmission codes.) 

The ASCII transmission code, in which the characters appear in main storage in ASCII code, is 
used by features #1310, #7850, #2095, and #2096. 
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The other transmission code is EBASC (mirror image ASCII) and is used by the 1610 and 2091 
controllers and the 2092 adapter, ebasc is the mirror image within a byte of the ASCII 
representation; the bits appear swapped end-for-end within each byte. For example, the 
character "1" would look as follows (internally): 








Hexadecimal 


Binary 


ASCII 


x'3r 


001 1 0001 


EBASC (mirror image ASCII) 


X'8C' 


1 0001 1 00 



Note that the bit representation of a character appearing at the terminal is the same for all 
attachments and the bit representation for all characters in the Series/ 1 is ASCII. However, 
depending upon the attachment, ASCII or EBASC is used as the transmission code. 

Note also that edx supports "no parity" only, but some ASCII terminals use even or odd. For 
information on the parity of a particular terminal, refer to the associated hardware manual. If 
you require even or odd parity, use the EXIO facility. 

A terminal can be directly attached (rs-422 or LOCAL) to the Series/ 1 or attached through a 
modem (remote). A remote terminal is connected to the Series/ 1 by an asynchronous 
(start/stop) communications line. The line can be point-to-point switched (SWITCHED) or 
point-to-point nonswitched (pttopt). The TERMCTRL instruction has operands that are used to 
control the modem; see the Language Reference. 

Before preparing terminal statements, you need to know the characteristics of your terminals, 
the way they will be attached to your Series/ 1, and how you plan to use them in your 
application. (Review the appropriate hardware manuals, and refer to the Language Reference 
and the Communications Guide.) 



Symbolic Reference to Terminals 



The label on the terminal statement assigns a name to the device for purposes of reference by 
the application program. Four such names have special meaning to the supervisor and should be 
assigned to the appropriate device: 

$SYSLOG Names the system logging device or operator station, and must be defined in 

every system. The starter supervisor defines $SYSLOG as a 4978 display station. 
$SYSLOG is the primary device to receive/display all exception messages. 

$SYSLOGA Names the alternate system logging device. If unrecoverable errors prevent use 
of $SYSLOG, the system will use the $SYSLOGA terminal as the system logging 
device/operator station. If defined, this device should be a terminal with 
keyboard capability, not just a printer. The starter supervisor defines the 
$SYSLOGA terminal as a teletypewriter device. 
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$SYSLOGB Names the second alternate system logging device. If unrecoverable errors 
prevent use of $SYSLOG, the system will use the $sysloga terminal as the 
system logging device/operator station. If no $sysloga terminal is defined or 
unrecoverable errors prevent the use of $SYSLOGA, the system will use the 
$SYSLOGB terminal as the system logging device/operator station. If defined, 
this device should be a terminal with keyboard capability, not just a printer. 
The starter supervisor defines the $SYSLOGB terminal as a 3101 Display 
Terminal in block mode. 

$SYSPRTR Names the system printer. If defined, the hard copy output from all system 
programs are directed to this device. The starter supervisor defines a 4974 
matrix printer as the $SYSPRTR device. 

Assignment of a name to a terminal designates that terminal as a global resource to be accessed 
by any application program through use of the ENQT and lOCB instructions described in the 
Language Reference. 

Coding the TERMINAL Statement 

In the following matrix, the DEVICE operand is listed across the top of the matrix. The operands 
that can be specified for a particular device as determined by the DEVICE operand are indicated 
by an X. 

Following the matrix, the syntax and operands for each supported device are described by !^ \ 

device type. \^' 

Notes: 

1 . All TERMINAL Statements must be grouped together with the last statement including an 
END=YES specification. 

2. Specify TYPE=DSECT on the terminal statement to include the EDL/copy code when 
assembling under $S1ASM and using the Macro Library. 

3. Labels on TERMINAL statements, tape IDs (see the TAPE definition statement), and volume 
names (see the DISK definition statement must be unique. Volume names or tape IDs must 
not match the label on a terminal statement. 

4. The maximum LINSIZE is device dependent but can never by greater than 254. 

If you use the Remote Management Utility and need the PASSTHRU function, two virtual 
terminals are required. (See "Examples and Defaults" on page IS-237 for a sample 
configuration.) (For a detailed description of the passthru function, see the Remote 
Management Utility chapter in Communications Guide.) 



\J 
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Device operand of TERMINAL statement 














Parameter 


2741 


4013 


4973 


4974 


4975 


5219 


5225 


5224 


4978 


4979 


4980 


ACCA 


TTY 


PROG 


VIRT 


GPIB 


S1S1 


ADAPTER 


X 








X 


X 


X 


X 






X 


X 












ADDRESS 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


ATTN 


















X 


X 


X 


X 


X 






X 




BITRATE 


X 








X 












X 


X 




X 








BOTM 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 










CHARDEL 


X 


X 




















X 


X 










CHARSET 










X 


X 


X 


X 




















CHKSUM 


































X 


COD 
























X 












CODTYPE 


X 


X 




















X 


X 


X 




X 




CR 


X 


X 




















X 


X 


X 








CRDELAY 


X 


X 




















X 


X 


X 








DI/DO/PI 




X 
































ECHO 


X 


X 






















X 










END 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


(1) 


HDCOPY 


















X 


X 


X , 














LEFTM 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 










LF 


X 


X 




















X 


X 


X 








LINEDEL 


X 


X 




















X 


X 










LINSIZE 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


LMODE 










X 














X 












MODE 
























X 


X 










NHIST 


















X 


X 


X 


X 












OVFLINE 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 










PAGSIZE 


X 


X 


X 


X 


X 


X 


X 


X 








X 


X 










PART 


X 


X 














X 


X 


X 


X 


X 






X 




PF1 


















X 


X 


X 


X 


X 










PORT 












X 


X 


X 






X 














RANGE 
























X 




X 








RIGHTM 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 










SCREEN 


X 


X 














X 


X 


X 


X 


X 






X 




SECADDR 












X 


X 


X 






X 














SPOOL 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 






X 




SYNC 






























X 






TIMERS 
























X 












TOPM 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 










TYPE 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 


(2) 



Figure 13. Device-Dependent Operands 
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2741 Terminal 



A TERMINAL definition statement with DEVICE=2741 defines a 2741 communications terminal 
attached via 1610 controller. 

Syntax: 



label TERMINAL DEVICE= ADDRESS=,PAGSIZE= LINSIZE= CODTYPE= 

TOPIVI=BOTM=LEFTM=RIGHTM=OVFUNE^ 
LINEDEL-,CHARDEL=CRDELAY=ECHO=BITRATE~ 
ADAPTER=CR=LF=SCREEN=PART=,SPOOL=END= 

Required: DEVICE= ADDRESS= 

Defaults: PAGSIZE=66,LINSIZE=130,CODTYPE=EBCD,TOPM=0,BOTM=65, 
LEFTM=0,RIGHTM=129,SCREEN=NO,OVFLINE=NO,LINEDEL=AO, 
CHARDEL=5D,CRDELAY=0,ECHO=YES,CR=5B,LF=5B,BITRATE=134, 
ADAPTER=SINGLE,PART=1,SP00L=N0,END=N0 



Operand Description 

DEVICE = 2741 communications terminal attached via 1610 controller. 

ADDRESS= The address (in hexadecimal) of the device. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
The default is pagsize=66. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is LINSIZE=130. 

CODTYPE= The transmission code used by the terminal. Specify either ebcd (PTTC/ebcd) or 
CRSP (FTTC/correspondence). The default is codtype=ebcd. 

TOPM= The top margin (a decimal number between zero and pagsize-i) to indicate the 

top of the logical page within the physical page for the device. The default is 

TOPM=0. 

BOTM= The bottom margin, the last usable Une on a page. Its value must be between 

TOPM+NHIST and PAGSIZE-I. If an output instruction would cause the line 
number to increase beyond this value, then a page eject, or wrap to line zero, is 
performed before the operation is continued. The default is botm=65. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and linsize-i. The default is LEFTM=0. 






^■' 
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2741 Terminal (continued) 



RIGHTM= A value (between leftm and LiNSiZE-i) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 
RIGHTM=129. 

OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is OVFLlNE=NO. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

LINEDEL= A two-digit hexadecimal character that defines the character to be entered to 

restart an input Une. In some cases, input of this character causes a repeat of the 
previous output message. The default is linedel=ao. 

CHARDEL= A two-digit hexadecimal character which indicates deletion of the previous input 
character. It is meaningful only for devices whose mode of transmission is one 
character at a time, as described in the linedel operand. The default is 

CHARDEL=5D. 

Note: When CHARDEL= and linedel= values are equal, no translation and 
editing will occur. 

CRDELAY= The number of idle times required for a carriage return to complete for 

teletypewriter devices. If printing occurs during the carriage return, CRDELAY is 
too small. The default is crdelay=o. 

ECHO= NO, for devices that do not require input characters to be written back (echoed) 

by the processor for printing. 

YES (the default) is appropriate for most devices connected through the 
teletypewriter adapter. 

BITRATE= The rate (in bits per second) that this terminal will be operating. The default is 
134 bits per second. 

ADAPTER= SINGLE, for the single-Une controller (the default). For 2741, only SINGLE is 
allowed. This operand should match the jumpers on the 1610 controller card. 
(Refer to Communications Guide for hardware considerations.) 



CR= 



The character the system tests in order to determine if a new line function is to 
be performed. The default is cr=5B. 
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LF= 



The character the system send to the terminal when a new Une function is to be 
performed. If the same value is coded for LF= as was coded (or defaulted) for 
CR= then the CR character which terminates an input operation will not be 
echoed to the terminal; the terminal is assumed to be an auto line-feed device. 
The default is lf=5B. 



SCREEN= YES or ROLL, for screens that are to be operated similar to a typewriter. When 
the screen is full, you must press the enter key for output to continue. 

NO (the default), for hard-copy devices. When the screen fills up, you do not 
have to press enter for output to continue. 

PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 



SPOOL= 



YES, to define the terminal as a valid spoolable device. 



NO (the default), to specify that the terminal is not a valid spoolable device. 
However, the spoolable characteristics of the terminal can be redefined at a later 
time using the STERMUTI utility. 



END= 



Examples and Defaults 



YES, for the last TERMINAL statement in a system definition module. The 
default is END=NO. 



In the following example, the default assignments for DEVICE=2741 are shown as if they were 
explicitly coded in the terminal statement. If a operand is not shown, then it is not relevant 
for the device. Address assignment is for illustration only. 



Example: IBM 2741 terminal terminal statement. 



label TERMINAL DEVICE=2741 , ADDRESS=08 

is equivalent to: 



label TERMINAL DEVICE=2741 , ADDRESS=08 ,PAGSIZE=66 ,LINSIZE=1 30 , 

CODTYPE=EBCD , TOPM=0 , BOTM=65 , LEFTM=0 , RIGHTM=1 29 , 
SCREEN=NO , OVFLINE=NO , LINEDEL=AO , CHARDEL=5D , 
CRDELAY=0 , ECHO=YES , CR=5B , LF=5B , BITRATE= 1 34 , 
ADAPTER=S INGLE, PART=1 , SPOOL=NO, END=NO 
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4013 Terminal 






A TERMINAL definition statement with device=4013 defines a Tektronix 4013 graphics terminal 
or similar device attached via 1560 adapter. 

Terminal support is provided for digital I/O devices such as the Tektronix 4000 Series of Display 
Terminals equipped with the General Purpose Parallel Interface (Tektronix Custom Feature 
Number CM02 1-0 109-03) or terminals having equivalent hardware interfaces. (Refer to the 
Communications Guide.) 

Syntax: 



label TERMINAL DEVICE= PAGSIZE= LINSIZE= CODTYPE= 

TOPM= BOTI\/l=,LEFTM=RIGHTM=OVFLINE= 
LINEDEL=CHARDEL=CRDELAY= ECHO= 
CR=LF=SCREEN=PART=DI=DO=PI= 
END= 

Required: DEVICE= ,and Dl= D0= or Pl= 

Defaults: PAGSIZE=35,LINSIZE=72,CODTYPE=ASCII,TOPM=0,BOTM=34, 
LEFTM=0,RIGHTM=71,SCREEN=NO,OVFLINE=NO,LINEDEL=7F, 
CHARDEL=08,CRDELAY=0,ECHO=YES,CR=0D,LF=0A,PART=1,END=NO 



Operand Description 

DEVICE= 4013 (or other 4000 Series) graphics terminal attached via 1560 adapter. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
For screen devices, specify the size of the screen in lines. The default is 

PAGSIZE=35. 

CODTYPE= The transmission code used by the terminal; in this case, ASCII. 

LINSIZE= The maximum length of an input or output Une for the device. The value of this 
operand can be less than the maximum which the device can accommodate (for 
example, 80 for the 4013 graphics terminal), but the value cannot be increased 
dynamically. The default is LINSIZE=72. 

TOPM= The top margin (a decimal number between zero and PAGSlZE-l) to indicate the 

top of the logical page within the physical page for the device. The default is 

TOPM=0. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and PAGSIZE-I. If an output instruction would cause the Une 
number to increase beyond this value, then a page eject, or wrap to line zero, is 
performed before the operation is continued. The default is botm=34. 
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4013 Terminal (continued) 



LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and LINSIZE-I. The default is leftm=o. 

RIGHTM= A value (between leftm and LiNSlZE-l) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 

RIGHTM=71. 

OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is ovfline=no. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

LINEDEL= A two-digit hexadecimal character that defines the character to be entered to 

restart an input line. In some cases, input of this character causes a repeat of the 
previous output message. The default is linedel=7F. 

For information on how to code this operand for ASCII terminals, refer to "ASCII 
Transmission Codes" on page IS- 184. 

CHARDEL= A two-digit hexadecimal character which indicates deletion of the previous input 
character. It is meaningful only for devices whose mode of transmission is one 
character at a time, as described in the linedel operand. The default is 

CHARDEL=08. 

Note: When CHARDEL= and LINEDEL= values are equal, no translation or 
editing will occur. 

CRDELAY= The number of idle times required for a carriage return to complete for 

teletypewriter devices. If printing occurs during the carriage return, CRDELAY is 
too small. The default is crdelay=o. 

ECHO= NO, for devices that do not require input characters to be written back (echoed) 

by the processor for printing. 

YES (the default) is appropriate for most devices connected through the 
teletypewriter adapter. See the LP parameter description regarding suppression 
of the echo of the CR character. 

CR= The character to be tested to determine if a new line function is to be performed. 

The default is CR=OD. 

For further information on how to code this operand for ASCII terminals, refer to 
"ASCII Transmission Codes" on page IS- 184. 



/' 
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4013 Terminal (continued) 



LF= 



The character to be sent to the terminal when a new line function is to be 
performed. If the same value is coded for LF= as was coded (or defaulted) for 
CR= then the CR character which terminates an input operation will not be 
echoed to the terminal; the terminal is assumed to be an auto line-feed device. 
The default is LF=OA. 






For further information on how to code this operand for ASCII terminals, refer to 
"ASCII Transmission Codes" on page IS-184. 

SCREEN= YES or ROLL, for screens that are to be operated similar to a typewriter. When 
the screen is full, you must press the enter key for the output to continue. 

NO (the default), for hard-copy devices. When the screen fills up, you do not 
have to press enter for the output to continue. 

DI= (address, termaddr) address - The digital input group address 

or 

termaddr - The hardware subaddress (0—7) of the terminal defining 
the value used to select the terminal for digital input 

DO = (address, termaddr) address - The digital output group address. 

or 

termaddr - The hardware subaddress (0-7) to define the digital 
output subaddress of the terminal. 



PI=(address,bit) 



address - The process interrupt group address. 



or 

bit - The bit (0—15) to define the particular interrupting point 
assigned to the terminal. 

PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 

You can change the partition assignment at execution time with the $CP operator 
command described in Operation Guide. 

END= YES, for the last terminal statement in a system definition module. The 

default is END=NO. 
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Example and Defaults 



In the following example, the default assignments forDEViCE=40l3 are shown as if they were 
explicitly coded in the terminal statement. If an operand is not shown, then it is not relevant 
for the device. Address assignment is for illustration only. 



Example: Tektronix 4013 (di/do parallel interface), terminal Statement 



label TERMINAL DEVICE=401 3 ,DI= (80 , 01 ) ,D0= (87 , 01 ) ,PI= (84, 04) 

is equivalent to: 



label TERMINAL DEVICE=401 3 , DI= (80 , 01 ) ,D0= (87 , 01 ) , 
PI=(84,04) ,PAGSIZE=35,LINSIZE=72, 
CODTYPE=ASCII , TOPM=0 , BOTM=34 , LEFTM=0 , 
RIGHTM=71 ,SCREEN=NO,OVFLINE=NO, 
LINEDEL=7F , CHARDEL=08 , CRDELAY=0 , ECHO=YES , 
CR=0D , LF=0A , PART= 1 , END=NO 



k.„ 
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4973/4974 Printers 



A TERMINAL definition statement with device=4973 (or 4974) defines a 4973 line printer 
attached via 5630 adapter or a 4974 matrix printer attached via 5620 adapter. 

Syntax: 



label 



Required: 
Defaults: 



TERMINAL DEVICE= ADDRESS= PAGSIZE= LINSIZE= TOPM= 

BOTIVI= LEFTM= RIGHTM=,OVFLINE=SPOOL=END= 

DEVICE= ADDRESS= 

PAGSIZE=66, LI NSIZE=1 32,TOPM=3, BOTM=63, LEFTM=0, 

RIGHTM=131,0VFLINE=N0,SP00L=YES,END=N0 



^■■•\ 



OperatuI Description 

DEVICE= One of the following device types: 

4973 4973 line printer attached via 5630 Adapter 

4974 4974 matrix printer attached via 5620 Adapter 

ADDRESS= The address (in hexadecimal) of the device. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
For printers, specify the number of lines per page. The default is PAGSIZE=66. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate (for 
example, 132 for the 4973 and 4974 printers), but the value cannot be increased 
dynamically. The default is linsize=132. 

TOPM= The top margin (a decimal number between zero and PAGSlZE-l) to indicate the 

top of the logical page within the physical page for the device. The default is 

TOPM=3. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and PAGSlZE-l. If an output instruction would cause the line 
number to increase beyond this value, then a page eject, or wrap to line zero, is 
performed before the operation is continued. The default is BOTM=63. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and linsize-1. The default is leftm=o. 

RIGHTM= A value (between leftm and linsize-i) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 

RIGHTM=131. 



Appendix A. System Definition Statements IS- 195 



TERMINAL - 4973/4974 



4973/4974 Printers (continued) 



OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next Une. The default is OVFLlNE=NO. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the appUcation program has taken no 
action to write the buffer to the device. 

SP0OL= YES (the default), to define terminal as a valid spoolable device. 

NO, to specify terminal is not a valid spoolable device. However the spoolable 
characteristics of the terminal can be redefined at a later time using the 
$TERMUT1 utility. 

END= YES, for the last TERMINAL statement in a system definition module. The 

default is END=NO. 



Example and Defaults 



In the following example, the default assignments for device=4973 (or 4974) are shown as if 
they were explicitly coded in the TERMINAL statement. If an operand is not shown, then it is not 
relevant for the device. Address assignment is for illustration only. 



Example: 4974 matrix printer terminal statement. 



label TERMINAL DEVICE=4974 , ADDRESS==^0 1 

is equivalent to: 



label terminal DEVICE=4974 , ADDRESS=01 ,PAGSIZE=66 , 
LINSIZE=1 32 , T0PM=3 , BOTM=63 , LEFTM=0 , 
RIGHTM= 131, OVFLINE=NO , SPOOL=YES , END=NO 
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4975 Printer 



A TERMINAL definition statement with DEVICE=4975 defines a 4975 matrix printer (connected 
locally or remotely) via a Mutlif unction Attachment Feature #1310 (mfa). 

Note: For the 4975-01 A printer, see the section headed TERMINAL - ACCA. 

Syntax: 



label 



Required: 
Defaults: 



TERMINAL DEVICE= ADDRESS= PAGSIZE= LINSIZE= CHARSET= 
TOPM= BOTM= LEFTM= RIGHTM=OVFLINE= 
BITRATE=LMODE=ADAPTER=SPOOL= END= 

DEVICE=ADDRESS= 

PAGSIZE=66,LINSIZE=132,CHARSET=USCA,TOPM=3,BOTM=63, 
LEFTM=0,RIGHTM=131,OVFLINE=NO,BITRATE=1200,LMODE=LOCAL, 
ADAPTER=MFA,SPOOL=YES,END=NO 



label 

Operand 

DEVICE= 



Required if ADAPTER = MFA; otherwise optional. 
Description 



One of the following device types: 



4975-OlL or -02L 



4975-OlR or -02R 



4975 matrix printer locally attached via #1310 (mfa) 
Adapter. 

4975 matrix printer remotely attached via #1310 (mfa) 
Adapter. 



ADDRESS = The address (in hexadecimal) of the device. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
For printers, specify the number of lines per page. The default is PAGSIZE=66. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is LINSIZE=132. 

For the 4975, the maximum number of characters contained on a line depends 
on the print density you specify with the TERMCTRL instruction or the $TERMUTl 
utility. For 4975 maximum line widths, see the PDEN= operand of the TERMCTRL 
instruction in the Language Reference. 



Appendix A. System Definition Statements IS- 197 



TERMINAL -4975 



4975 Printer (continued) 



CHARSET= Select the character set for the device, 
sets: 



Specify one of the following character 



AUGE Austrian and German 

BELG Belgian 

BRZL Brazilian 

DNNR Danish and Norwegian 

FRAN French (France) 

FRCA French (Canadian) 

INTL International (multinational) 

ITAL Itahan 

JAEN Japanese/English 

KANA Japanese katakana 

PORT Portuguese 

SPAN Spanish (Spain) 

SPNS Spanish (countries other than Spain) 

SWFI Swedish and Finnish 

UKIN EngUsh (United Kingdom) 

use A EngUsh (United States and Canada). 

The default character set is USCA. In addition, the characters per inch and the 
print mode for the 4975 are automatically set as follows: 

Model 1 10 characters per inch 

Model 2 10 characters per inch (draft mode). 

These values remain in effect until you change them using either the termctrl 
instruction or the $TERMUTl utility. 

TOPM= The top margin (a decimal number between zero and pagsize-i) to indicate the 

top of the logical page within the physical page for the device. The default is 

T0PM=3. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and PAGSIZE-1. If an output instruction would cause the Une 
number to increase beyond this value, then a page eject, or wrap to line zero, is 
performed before the operation is continued. The default is B0TM=63. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and LINSIZE-I. The default is leftm=o. 

RIGHTM= A value (between leftm and LiNSiZE-l) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 

RIGHTM=131. 



^r^ 
WJ 
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4975 Printer (continued) 



OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is ovfline=no. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

BITRATE= The rate (in bits per second) that this terminal will be operating. The bitrate 
parameter is vaUd only for remotely attached 4975 Models OIR and 02R and is 
not used for a locally attached 4975 Models OIL or 02L. 

1200 The default for printers directly connected (lmode=LOCAL) or running 
on asynchronous modems. This is the only bit rate allowed for the 4975 
Model OIR. 

2400 For the 4975 Model 02R set to 2400 bits per second either directly 
attached or running on asynchronous modems. 

4800 For the 4975 Model 02R set to 4800 bits per second either directly 
attached or running on asynchronous modems. 

EXT For the 4975 Model 02R that is running on a synchronous modem. 

"N Note: 4975 internal clocking bit rates are determined by the switch settings on 

^jy' the printer. 

LMODE= For 4975 R (RS-232) support connected via the #1310 attachment, there are 
two options: LOCAL and pttopt. The default is lmode=local. 

LOCAL means a 4975 R model is directly connected to a Series/ 1 with no 
modems, pttopt means a 4975 R model connected to a Series/ 1 on a leased 
line with internal (1200 BPS) or external (1200, 2400, or 4800 bps) modems. 

This parameter is not valid for 4975 L (rs-422) support. 

ADAPTER= MFA, for a Multifunction Attachment Feature #1310. (The 1310 Multifunction 
Attachment is defined with the adapter definition statement.) 

SPOOL = YES (the default), to define terminal as a valid spoolable device. 

NO, to specify terminal is not a valid spoolable device. However, the spoolable 
characteristics of the terminal can be redefined at a later time using the 
$termuti utility. 

END= YES, for the last terminal statement in a system definition module. The 

default is end=no. 
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4975 Printer (continued) 



Examples and Defaults 



In the following examples, the default assignments for device=4975 (local and remote) are 
shown as if they were explicitly coded in the TERMINAL statement. If an operand is not shown, 
then it is not relevant for the device. Address assignments are for illustration only. 



o 



Example 1: 4975-OlR matrix printer terminal statement (remotely attached). 



label 



TERMINAL DEVICE=4975-0 1 R , ADDRESS=4C , 
LMODE=PTTOPT 



is equivalent to: 



label TERMINAL DEVICE=4975-01R, ADDRESS=4C, 

PAGSIZE=66 , LINSIZE= 132, CHARSET=USCA, T0PM=3 , 
BOTM=63 , LEFTM=0 , RIGHTM= 131, OVFLINE=NO , 
BITRATE= 1200, LMODE^PTTOPT , SPOOL=YES , END=NO 



Note: For remote attachment, you must specify lmode=pttopt as shown, in which case the 
BITRATE defaults to 1200. Other valid bit rates for the 4975 Models OIR and 02R are 2400 and 
4800 bits per second. 



Example 2: 4975-02L matrix printer terminal statement (locally attached). 



label terminal DEVICE=4975-02L,ADDRESS=4D 

is equivalent to: 



label TERMINAL DEVICE=4975-02L, ADDRESS=4D, C 

PAGSIZE=66 , LINSIZE=1 32 , CHARSET=USCA, T0PM=3 , C 
BOTM=63 , LEFTM=0 , RIGHTM=1 3 1 , OVFLINE=NO , SPOOL=YES 



V..,y 



Note: The BITRATE and lmode operands are not used for local models of the 4975 because 
LMODE= will always be local and bitrate=2400 for the 497 5 -OIL and bitrate=4800 for the 
4975-02L. 
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4978/4979 Display Terminals 



A TERMINAL definition statement with device=4978 (or 4979) defines a 4978 display station 
attached via RPQ D02038 or a 4979 display station attached via 3585 adapter. 

Syntax: 



label 



Required: 
Defaults: 



TERMINAL DEVICE= ADDRESS^ LINSIZE= TOPM= BOTIVI= 
NHIST= LEFTM=RIGHTM=OVFLINE= HDCOPY= 
ATTN= PF1=SCREEN=PART=SP00L=END= 

DEVICE=ADDRESS= 

LINSIZE=80,TOPM=0,NHIST=12,BOTM=23, 
LEFTM=0,RIGHTM=79,SCREEN=ROLL,OVFLINE=NO,ATTN=YES, 
PF1=02,HDCOPY=$SYSPRTR,PART=1,SPOOL=NO,END=NO 






Operand Description 

DEVICE= One of the following device types: 

4979 4979 display station attached via 3585 Adapter 

4978 4978 display station attached via RPQ D02038 

ADDRESS= The address (in hexadecimal) of the device. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate (for 
example, 80 for the 4978/4979 display station), but the value cannot be 
increased dynamically. The default is LINSIZE=80. 

TOPM= The top margin (a decimal number between zero and the page size (24) minus 1) 

to indicate the top of the logical page within the physical page for the device. 
The default is topm=o. 

NHIST= The number of history lines to be retained when a page eject is performed. The 

line at TOPM+NHIST corresponds to logical line zero for purposes of the terminal 
I/O instructions. When a page eject (line=o) is performed, the screen area from 
TOPM to TOPM+NHlST-l will Contain lines from the previous page. (See the 
discussion of the screen operand which follows.) The default is nhist=12. 

Note: This operand is meaningful for roll screens only. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and the page size which is 24. If an output instruction would cause 
the line number to increase beyond this value, then a page eject, or wrap to line 
zero, is performed before the operation is continued. The default is BOTM=23. 
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LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and LINSIZE-I. The default is leftm=o. 

RIGHTM= A value (between leftm and linsize-i) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 

RIGHTM=79. 






OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is ovfline=no. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 



HDCOPY= The name of the terminal to which the contents of the screen can be printed. 
The default is hdcopy=$sysprtr. 



HDCOPY= (terminal name, key) 



terminal name The symbolic name of the terminal to which the hard-copy 

contents will be directed. 

key The code of the program function key which is to invoke 

the function. For example, hdcopy=($SYSPRTR,4) 
designates $sysprtr as the hard-copy device and pf4 as 
the activating key. If the hard-copy terminal name alone is 
specified, for example hdcopy=$sysprtr, then the default 
is PF6. 



\4 _ jfi 



Notes: 

1. The terminal specified (terminal name) must not be defined with attn=no. 

2. If a terminal error occurs, for example, the printer is not turned on, your 
output may be lost. 

ATTN= NO, if the attention key and the PF keys are to be disabled for the terminal. 

Such disabling is then permanent for the generated system. If you do not specify 
ATTN=, the default is attn=yes. 

YES or ALL, if all attention functions are to be enabled for the terminal. 

LOCAL, to limit the attention functions to those defined by ATTNLISTs within 
programs loaded from the terminal. 

NOSYS, to exclude only the system functions ($L, $c, and so forth). 



o 
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4978/4979 Display Terminals (continued) 
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NOGLOB, to exclude only the global attnlist functions, (global is the 
ATTNLIST of all programs in the same partition at one time.) 

Note: This operand can also be entered with a two-digit hexadecimal character 
for the attention key if the system default is not desired. 

The attention key can be redefined with a two-digit hexadecimal character. 

(For more information on modifying the default attention key, refer to the 
description of $TERMUT2 utility in Operator Commands and Utilities Reference.) 

Note: If the terminal being defined is specified in the HDCOPY= parameter of 
another terminal, do not code attn=no. 

PFl = The two-digit hexadecimal character which you want the system to interpret as 

PF key 1. The system interprets successive values as PF2 and PF3. The default is 
PFl =02. 

SCREEN = YES or ROLL (the default), for screens that are to be operated similar to a 

typewriter. When the screen is full, you must press the enter key for the output 
to continue. 

NO, for hard-copy devices. For 4978 or 4979 display devices, when the screen 
fills up, you do not have to press enter for the output to continue. 

STATIC, for a full-screen mode of operation, if full-screen mode is supported for 
the device. 

Note: The initial terminal definition should be STATIC only if the terminal is 
reserved for data display and data entry operations. Normal system operations, 
such as those directed to $SYSLOG or those involving the utility programs, assume 
a roll screen configuration. The appUcation program can define the static screen 
configuration by means of the enqt and lOCB instructions described in the 
Language Reference. 



Appendix A. System Definition Statements IS-203 



TERMI NAL - 4978/4979 



4978/4979 Display Terminals (continued) 



PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 

You can change the partition assignment at execution time with the $CP operator 
command described in the Operation Guide. 

SPOOL= YES, to define terminal as a valid spoolable device. 

NO (the default), to specify terminal is not a valid spoolable device. However, 
the spoolable characteristics of the terminal can redefined at a later time using 
the $TERMUTl utility. 

END= YES, for the last terminal statement in a system definition module. The 

default is END=NO. 



o 



Example and Defaults 



In the following example, the default assignments for the 4978/4979 display stations are shown 
as if they were explicitly coded in the terminal statement. If an operand is not shown, then it 
is not relevant for the device. Address assignment is for illustration only. 

Example: 4978 display terminal terminal statement. 



label TERMINAL DEVICE-4978,ADDRESS=04 

is equivalent to: 



label TERMINAL DEVICE=4978 , ADDRESS=04 ,LINSIZE=80 , 

TOPM=0 , NHIST=1 2 , BOTM=23 , LEFTM=0 , RIGHTM=79 , 
SCREEN=R0LL , OVFLINE=NO , ATTN^YES , PF 1 =02 
HDC0PY=$SYSPRTR,PART=1 , SPOOL=NO, END=NO 



\^ 



c 
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4980 Display Station 



A TERMINAL definition statement with device=4980 defines a 4980 display station attached via 
the Multidrop Work Station Attachment Feature (#1250). 

Syntax: 



label TERMINAL DEVICE= ADDRESS= LINSIZE= TOPM= BOTM= 

NHIST=BITRATE=LEFTM=,RIGHTM=OVFLINE= 
HDCOPY=ATTN= PF1=SCREEN=PART=SP00L= 
ADAPTER=PORT=SECADDR= END= 

Required: DEVICE= ADDRESS= ADAPTER= PORT= SECADDR= 

Defaults: LINSIZE=80,TOPM=0,BOTM=23,NHIST=12,BITRATE=100, 

LEFTM=0,RIGHTM=79,OVFLINE=NO,HDCOPY=$SYSPRTR, 
ATTN=YES,PF1=02,SCREEN=ROLL,PART=1,SPOOL=NO,END=NO 



Operand Description 

label A 1—8 alphanumeric character label beginning with a letter or one of the 

following special characters: $, #, or @. 

DEVICE= 4980, for the 4980 display station. 

ADDRESS= The address (in hexadecimal) of the device. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum that the device can accommodate, but the 
value cannot be increased dynamically. The default is linsize=80. 

TOPM= The top margin (a decimal number between zero and 23; that is, the page size 

minus 1 ) to indicate the top of the logical page within the physical page for the 
device. The default is TOPM=0. 

NHIST= The number of history lines to be retained when a page eject is performed. The 

line at TOPM+NHIST corresponds to logical line zero for purposes of the terminal 
I/O instructions. When a page eject (LiNE=o) is performed, the screen area from 
TOPM to TOPM+NHlST-l will Contain pages from the previous page. (See the 
discussion of the SCREEN operand which follows.) The default is NHIST=12. 

Note: This operand is meaningful for roll screens only. 
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BITRATE= The line speed (in K bits per second) at which the 4980 operates. The default is 
lOOK bits per second. The valid line speeds are 100, 250, and 500. All 
terminals on one port must be the same line speed and must match the line speed 
set on the back of the terminal. See the 4980 Display Station Description and 
Reference Manual, GA21-9296, for switch settings. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and the page size which is 24. If an output instruction causes the 
line number to increase beyond this value, then a page eject occurs before the 
operation is continued. The default is BOTM=23. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and linsize-i. The default is LEFTM=o. 

RIGHTM= A value (between leftm and LiNSiZE-l) that determines the last usable character 
position within a line. Position numbering begins at zero. The default is 
RIGHTM=79. 

OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next Une. The default is OVFLlNE=NO. 



HDCOPY= 



The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

The name of the terminal to which the contents of the screen can be printed. 
The default is hdcopy=$sysprtr. 



(I f 



HDCOPY= (terminal name, key) 



terminal name The symbolic name of the terminal to which the hard-copy 

contents will be directed. 



key 



The code of the program function key which is to invoke 
the function. For example, hdcopy=($SYSPRTR,4) 
designates $SYSPRTR as the hard-copy device and PF4 as 
the activating key. If you specify the name of the 
hard-copy terminal alone (for example 
hdcopy=$sysprtr), then the default is pf6. 



c # 
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4980 Display Station (continued) 
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Notes: 

1. The terminal specified (terminal name) must not be defined with attn=no. 

2. If a terminal error occurs (for example, if the printer is not turned on), your 
output may be lost. 

ATTN= NO, if the attention key and the pf keys are to be disabled for the terminal. 

Such disabling is then permanent for the generated system. 

YES (the default) or ALL, if all attention functions are to be enabled for the 
terminal. 

LOCAL, to limit the attention functions to those defined by ATTNLISTs within 
programs loaded from the terminal. 

NOSYS, to exclude only the system functions (such as ($L, OR $c). 

NOGLOB, to exclude only the global ATTNLIST functions. (GLOBAL is the 
ATTNLIST of all programs in the same partition at one time.) 

Note: You can also enter this operand with a two-digit hexadecimal character 
for the attention key if the system default is not desired. 

You can redefine the attention key with a two-digit hexadecimal character. 

(For more information on modifying the default attention key, refer to the 
description of $TERMUT2 utility in Operator Commands and Utilities Reference.) 

Note: If the terminal being defined is specified in the HDCOPY= parameter of 
another terminal, do not code ATTN=NO. 

PFl = The two-digit hexadecimal character that you want the system to interpret as PF 

key 1. The system interprets successive values as PF2 and PF3. The default is 
PFl =02. 

SCREEN = YES or ROLL (the default), for screens that are to be operated similar to a 

typewriter. When the screen is full, you must press the enter key for the output 
to continue. 

NO, for hard-copy devices. For the 4980 display station, when the screen fills 
up, you do not have to press enter for the output to continue. 

STATIC, for a full-screen, if full-screen is supported for the device. 
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PART= 



Note: The initial terminal definition should be static only if you reserve the 
terminal for data display and data entry operations. Normal system operations, 
such as those directed to $SYSLOG or those involving the utiUty programs, assume 
a roll screen configuration. The appHcation program can define the static screen 
configuration by means of the ENQT and lOCB instructions described in the 
Language Reference. 



The partition ( 1 • 
is partition 1 . 



■8) with which the terminal is normally associated. The default 






You can change the partition assignment at execution time with the $CP operator 
command described in Operation Guide. 



SPOOL = YES, to define terminal as a spoolable device. 

NO (the default), to specify terminal is not a spoolable device. However, you 
can redefine the spoolable characteristics of the terminal at a later time using the 
$TERMUTl utility. 

ADAPTER= SMIO, for the Multidrop Work Station Attachment Feature #1 250. 

PORT= The physical port on the Multidrop Work Station Attachment where the cable is 

connected. Its value can be or 1 . 

SECADDR= The address set by the switches on the back of the 4980. Each terminal 

connected through the same port on the SMIO must have a unique secondary 
address. Its value must be between 01 and FE (hex). See the 4980 Display 
Station Description and Reference Manual, GA2 1-9296, for switch settings. 

END= YES, for the last TERMINAL statement in a system definition module. The 

default is end=no. 



/T 



\V 



IS-208 SC34-0646 



TERMINAL -4980 



o 



4980 Display Station (continued) 



Example and Defaults 



In the following example, the default assignments for the 4980 display station are shown as if 
they were expUcitly coded in the terminal statement. If an operand is not shown, then it is not 
relevant for the device. Address assignment is for illustration only. 



Example: 4980 Display Station terminal statement. 



label TERMINAL DEVICE=4980 , ADDRESS=80 , ADAPTER=SMIO, 
PORT=0 , SECADDR=0 1 

is equivalent to: 



label TERMINAL DEVICE=4980 , ADDRESS=80 , ADAPTER=SMIO, 

PORT=0 , SECADDR=0 1 , TOPM=0 , NHI ST= 1 2 , BITRATE= 100, 
BOTM=23 , LEFTM=0 , RIGHTM=79 , SCREEN=ROLL , 
OVFLINE=NO , ATTN=YES , PF 1 =02 , PART= 1 , 
HDCOPY=$SYSPRTR,SPOOL=NO,END=NO 
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5219/5224/5225 Printers 



A TERMINAL definition statement with device=5219/5224/5225 defines one of the following 
printers: 

• 5219 printer 

• 5224 printer 

• 5225 printer. 

connected to the Series/ 1 via the Printer Attachment - Series 5200 (#5640). 
Syntax: 



label TERMINAL DEVICE= ADDRESS= PAGSIZE= LINSIZE= CHARSET= 

TOPM=BOTIVI=LEFTM=RIGHTM=OVFLINE= 
ADAPTER=SPOOL=PORT=SECADDR=END= 

Required: DEVICE= ADDRESS= ADAPTER= PORT= SECADDR= 
Defaults: PAGSIZE=66,LINSIZE=132,CHARSET=USCA,TOPM=3,BOTM=63, 
LEFTM=0,RIGHTM=131,OVFLINE=NO,SPOOL=YES,END=NO 



label 



Operand 



Required 
Description 



DEVICE= One of the following device types: 

5219 5219 printer locally attached via the Printer Attachment - 5200 Series 

5224 5224 printer locally attached via the Printer Attachment - 5200 Series 

5225 5225 printer locally attached via the Printer Attachment - 5200 Series. 

ADDRESS= The address (in hexadecimal) of the device. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
For printers, specify the number of lines per page. The default is pagsize=66. 



v., V 



LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The length of an input or output line 
can be set at either 132 or 198. The default is LINSIZE=132. 
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5219/5224/5225 Printers (continued) 



CHARSET= Select the character set for the device. Specify one of the following character 

sets: 

AUGE Austrian and German 

BELG Belgian 

BRZL BraziUan 

DNNR Danish and Norwegian 

FRAN French (France) 

FRCA French (Canada) 

INTL International (multinational) 

ITAL Italian 

JAEN Japanese/EngUsh 

KANA Japanese katakana 

PORT Portuguese 

SPAN Spanish (Spain) 

SPNS Spanish (countries other than Spain) 

SWFI Swedish and Finnish 

UKIN EngUsh (United Kingdom) 

use A English (United States and Canada). 

The default character set is USCA. 



In addition, the characters per inch for the printers (all models) are automatically 
set at 10 character per inch. 

These values remain in effect until you change them using either the TERMCTRL 
instruction or the $TERMUTl utility. 



TOPM= The top margin (a decimal number between zero and PAGSlZE-l) to indicate the 

top of the logical page within the physical page for the device. The default is 

TOPM=3. 

BOTM= The bottom margin, the last usable hne on a page. Its value must be between 

TOPM+NHIST and PAGSiZE-i. If an output instruction would cause the line number 
to increase beyond this value, then a page eject, or wrap to hne zero, is 
performed before the operation is continued. The default is botm=63. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and LINSIZE-I. The default is leftm=o. 

RIGHTM= A value (between leftm and linsize-i) that determines the last usable character 
position within a Une. Position numbering begins at zero. The default is 
RIGHTM=131. 
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5219/5224/5225 Printers (continued) 



OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is OVFLlNE=NO. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

ADAPTER= ALPA, for the Printer Attachment - 5200 Series (#5640). (The Printer 

Attachment - 5200 Series is defined with the adapter definition statement.) 

SPOOL= YES, to define terminal as a valid spoolable device. 

NO, to specify terminal is not a valid spoolable device. However, the spoolable 
characteristics of the terminal can be redefined at a later time using the 
STERMUTl utility. 



/f T\ 



PORT= 



for the first port, 1 for the second port. 



SECADDR= If you specify PORT=0, the second address must be 00 through 06. If you specify 
PORT=l, the second address must also be 00 through 06. For the 5219, this 
address must correspond to the address set by the switches on the back of the 
5219 printer. 



END= 



Examples and Defaults 



YES for the last TERMINAL statement in a system definition module. The default 
is END=YES. 



In the following examples, the default assignments for device=5219/5224/5225 are shown as if 
they were explicitly coded in the terminal statement. If an operand is not shown, then it is not 
relevant for the device. Address assignments are for illustration only. 



v..y 



Example 1 : 5224 printer terminal statement. 



label TERMINAL DEVICE=5224 , ADDRESS=58 , 

ADAPTER=ALPA , PORT=0 , SECADDR=0 1 

is equivalent to: 



label terminal DEVICE=5224,ADDRESS=58,ADAPTER=ALPA, 

PAGSIZE=66,LINSIZE=132,CHARSET=USCA,T0PM=3, 
B0TM=6 3 , LEFTM=0 , RIGHTM= 131, OVFLINE=NO , 
PORT=0 , SECADDR=0 1 , SPOOL=YES , END=NO 
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5219/5224/5225 Printers (continued) 



Example 2: 5225 printer terminal statement (locally attached). 



label TERMINAL DEVICE=5225 ,ADDRESS=58, 

ADAPTER=ALPA , PORT=0 , SECADDR=06 

is equivalent to: 



label TERMINAL DEVICE=5225 , ADDRESS=58, ADAPTER=ALPA, C 

PAGSIZE=66 , LINSIZE=1 32 , CHARSET=USCA, T0PM=3 , C 

B0TM=6 3 , LEFTM=0 , RIGHTM= 131, OVFLINE=NO , SPOOL=YES C 
PORT=0 , SECADDR=06 , END=YES 



Example 3: 5219 printer terminal statement (locally attached). 



label TERMINAL DEVICE=521 9, ADDRESS=58, 

ADAPTER=ALPA , PORT=0 , SECADDR=0 1 

is equivalent to: 



label TERMINAL DEVICE=52 1 9 , ADDRESS=58 , ADAPTER=ALPA, 

PAGSIZE=66 , LINSIZE=1 32 , CHARSET=USCA, T0PM=3 , 
B0TM=6 3 , LEFTM=0 , RIGHTM= 131, OVFLINE=NO , 
SPOOL^YES , PORT=0 , SECADDR=0 1 , END=YES 
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A TERMINAL definition statement witli device=acca means that the terminal is connected to 
the Series/ 1 using an asynchronous communications control adapter (ACCA). ACCA adapters, by 
feature number, are #13 10, #1610, #2091 with #2092, and #2095 with #2096 or with RPQ 
D02350. Except for #2095 with RPQ D02350, which supports only locally-attached 3101s, these 
adapters support both locally-attached and remote terminals. 

Syntax: 



label 



TERMINAL 



DEVICE=ADDRESS=MODE=PAGSIZE= 
LINSIZE=CODTYPE=TOPM=BOTM=NHIST= 
LEFTM= RIGHTM=OVFLINE=LINEDEL= 
CHARDEL=CRDELAY=COD=BITRATE= 
RANGE=,LMODE=ADAPTER=CR=,LF=,ATTN=, 
PF1=,SCREEN= PART=TIMERS=SPOOL= END= 



Required: DEVICE= ADDRESS= 

Defaults: PART=1,END=N0,0VFLINE=N0,ATTN=YES,SP00L=N0 



label Required if ADAPTER=MFA; otherwise optional 

Operand Description 

DEVICE= ACCA, for an ASCII terminal attached via a 1610 controller, a 2091 controller 

with 2091 adapter, a 2095 controller with a 2096 adapter, or a 4975-01 A ASCII 
Printer attached via a #2095/2096 or a 1310 (mfa). 



U J 



or 



ACCA, for a 3101 Display Terminal in either block or character mode attached 
via any of the methods above. 



or 



ACCA, for the Remote Support Link. (See "Examples and Defaults" on page 
IS-223 for examples.) 

ADDRESS= The address (in hexadecimal) of the device. 



o 



IS-214 SC34-0646 



TERMINAL -ACCA 






ACCA-Type Terminals (continued) 



MODE= 



3101C, foraSlOl Display Terminal that operates in character mode. 



3101B, for a 3101 Display Terminal that operates in block mode. 

4795-OlA, for a 4975-OlA ASCII Printer. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 
For printers, specify the number of lines per page. For screen devices, specify the 
size of the screen in lines. This operand is not required for the 3101 Display 
Terminal in block mode; the system sets pagsize to 24 regardless of your 
specification. 

CODTYPE= The transmission code used by the terminal. Specify either ASCII or ebasc (8 bit 
data interchange code) as in the following table: 





Adapter 




1610 


2091/2092 


2095/2096 


1310 (MFA) 


EBASC 


EBASC 


ASCII 


ASCII 



C"^^ 
^ 



For example, if DEVICE=ACCA and the device is connected with a 2095 eight-Une 
controller and a 2096 adapter, specify CODTYPE=ASCll. 

Specify ASCII for a 3101 Display Terminal in either block mode or character 
mode for a 497 5 -01 A Printer. 



LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate (for 
example, 80 for the 3101 display station in character mode), but the value 
cannot be increased dynamically. 

This operand is not required for the 3101 Display Terminal in block mode; the 
system sets LINSIZE to 80 regardless of your specification. 

TOPM= The top margin (a decimal number between zero and PAGSIZE- 1) to indicate the 

top of the logical page within the physical page for the device. 

This operand is not required for the 3101 Display Terminal in block mode; the 
system sets TOPM to regardless of your specification. 
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NHIST= This operand is not required for the 3101 Display Terminal in block mode; the 

system sets nhist to regardless of your specification. 

Note: This operand is meaningful for roll screens only. 

BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and pagsize-i. If an output instruction causes the line number to 
increase beyond this value, then a page eject occurs before the operation is 
continued. 

This operand is not required for the 3101 Display Terminal in block mode; the 
system sets BOTM to 23 regardless of your specification. 

LEFTM= The left margin, the character position at which input or output will begin. 

Specify a decimal value between zero and LINSIZE-I. 

This operand is not required for the 3101 Display Terminal in block mode; the 
system sets leftm to regardless of your specification. 

RIGHTM= A value (between leftm and linsize-i) that determines the last usable character 
position within a line. Position numbering begins at zero. 

This operand is not required for the 3101 Display Terminal in block mode; the 
system sets rightm to 79 regardless of your specification. 

OVFLINE= YES, if output lines which exceed the right margin are to be continued on the 
next line. The default is OVFLINE=no. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

LINEDEL= A two-digit hexadecimal character that defines the character the operator will 
enter when he wishes to restart an input line. In some cases, input of this 
character causes a repeat of the previous output message. 

This operand is usually not meaningful for the 3101 Display Terminal in block 
mode; editing is done by the device with keys such as delete and BACKSPACE 
before the edited characters are sent to the Series/ 1 . 

For ACCA terminals attached via the 1610 or 2091 controllers and the 2092 
adapter, code in mirror image. For information on how to code this operand for 
ASCII terminals, refer to "ASCII Transmission Codes" on page IS-184. 
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ACCA-Type Terminals (continued) 



CHARDEL= A two-digit hexadecimal character which indicates deletion of the previous input 
character. It is meaningful only for devices whose mode of transmission is one 
character at a time, as described in the linedel operand. 



CRDELAY= 



For ACCA terminals attached via the 1610 or 2091 controllers and the 2092 
adapter, enter in mirror image. For further information on how to code this 
operand for ASCII terminals, refer to "ASCII Transmission Codes" on page 
IS-184. 

Note: When CHARDEL= and LINEDEL= values are equal, no translation or 
editing will occur. 

The number of idle times required for a carriage return to complete for 
teletypewriter devices. If printing occurs during the carriage return, crdelay is 
too small. 






BITRATE= The rate (in bits per second) that this terminal will be operating. For terminals 
with switch-selectable speed settings, BITRATE must match the switch setting on 
the terminal. (Refer to the IBM 3101 Display Terminal Description, GAl 8-2033 
for information on switch settings). For best performance on the 3101 in block 
mode, specify 9600 if you do not use modems or the maximum speed capacity of 
the modem you use. 

For the 497 5 -01 A ASCII Printer attached via a Feature Programmable Card 
(#2095/2096), specify BiTRATE=1200 or 4800. If you attach the printer via a 
Multifunction Attachment Feature #1310, specify bitrate= 1200 only. 

For ACCA terminals, you may specify bitrate=0. You should only specify this 
bit rate if the terminal is attached via the #2095 controller and the #2096 adapter 
and uses the external clock. 

Notes: 

1. The MFA (#1310) can run only at 1200 bits per second for the 497 5 -01 A 
ASCII Printer and 1200, 2400, and 9600 bits per second for other terminals. 

2. For the Remote Support Link, specify bitrate=1200. (See "Examples and 
Defaults" on page IS-223 for examples.) 

Default BITRATE is 300 bits per second; the default for mfa is 1200 bits per 
second. 
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ACCA-Type Terminals (continued) 



RANGE= Enter HIGH or LOW to match hardware jumper that is installed on the adapter 
card. The Multifunction Attachment does not have a speed range jumper. 

On the 3101 Display Terminal in block mode, specify HIGH for best 
performance. 

Default RANGE is HIGH. 

LMODE= For ACCA devices, four options are available: RS-422, LOCAL, SWITCHED, or 

PTTOPT. 



J 



RS-422 



For a terminal directly attached to any port of the 
Multifunction Attachment Feature #1310. 



LOCAL For a terminal directly attached. For the Multifunction 

Attachment Feature #1310, the terminal must be attached on 
the base address only. 

SWITCHED For a connection that is point-to-point switched. For the 

Multifunction Attachment Feature #1310, the terminal must 
be attached on the base address only. 

PTTOPT For a connection that is point-to-point nonswitched. For the 

the Multifunction Attachment Feature #1310, the terminal 
must be attached on the base address only. 

The LMODE specified should match the jumpers on the controller cards. The 
Multifunction Attachment does not have jumpers. (Refer to Appendix 
B, "Customizing Adapters with Hardware Jumpers" on page IS-243 for 
hardware considerations.) 

Note: Specify LMODE=SWiTCHED for the Remote Support Link. (See 
"Examples and Defaults" on page IS-223 for examples.) 






C 
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ACCA-Type Terminals (continued) 






ADAPTER= One of the following to indicate the ACCA type: 

SINGLE For a single-line controller (the default) 

TWO For an eight-line controller with up to two Unes active 

FOUR For an eight-line controller with up to four lines active 

SIX For an eight-line controller with up to six lines active 

EIGHT For an eight-line controller with up to eight Unes active 

MFA For a Multifunction Attachment Feature #1310. 

All multiple-Une asynchronous controller/adapter cards (2091/2092 or 
2095/2096) must start at a base address ending with X'O' or X'8'. A terminal 
statement with DEVICE=ACCA must exist for the line at the base address. 
Furthermore, the terminal defined as the base address must be specified as the 
first terminal for the multiUne controller. The remaining terminals defined on the 
multihne controller {if any) must immediately follow the base address terminal 
and should be in ascending order by address. 

All 3101 terminals attached via the Multifunction Attachment (1310) must 
specify adapter =mf A. 

COD= Additional characters, other than the CR=, ATTN=, and LINEDEL= values, that 

will terminate a readtext operation. You may enter from one to four 
characters, (cod means change of direction, for example, read to write.) When 
the system receives any COD characters, it passes them to the READTEXT data 
area. Code in ASCII mirror image as follows (depending upon device type) : 



C0D=11 

or 

COD=(12,B6,42,B3, . . ) 



CR= 



The character to be tested to determine if a new line function is to be performed. 
When the system receives any CR characters, it does not pass them to the 
READTEXT data area. (Code in mirror image for ACCA terminals attached via the 
1610 or 2091 controllers with the 2092 adapter.) 

Default CR is BO for EBASC and OD for ASCII. 
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ACCA-Type Terminals (continued) 



LF= The character to be sent to the terminal when a new Une function is to be 

perfonned. Code in mirror image for ACCA terminals attached via the 1610 or 
2091 controllers with the 2092 adapter. If the same value is coded for LF= as 
was coded (or defaulted) for CR= then the CR character which terminates an 
input operation will not be echoed to the terminal; the terminal is assumed to be 
an auto line-feed device. 

Default LF is 50 for EBASC and OA for ASCII. 

ATTN= NO, if the attention key and the PF keys are to be disabled for the terminal. 

Such disabling is then permanent for the generated system. 

YES (the default) or ALL, if all attention functions are to be enabled for the 
terminal. 

LOCAL, to limit the attention functions to those defined by ATTNLISTs within 
programs loaded from the terminal. 

NOSYS, to exclude only the system functions ($L, $C, and so forth). 

NOGLOB, to exclude only the global Attnlist functions. (GLOBAL is the 
ATTNLIST of all programs in the same partition at one time.) 

Note: This operand can also be entered with a two-digit hexadecimal character 
for the attention key if the system default is not desired. 

The attention key can be redefined with a two-digit hexadecimal character for 
ASCII terminals. 

For terminals attached via the 1610 or 2091 controllers and the 2092 adapter, 
use mirror image. 

For the 3101 Display Terminal in either character or block mode, the system 
defines the PF8 key as the default attention key. If you do not want the system 
default, specify two characters (four hexadecimal digits) representing the first 
and second characters of a 3101 PF key sequence. If only one character (two 
hexadecimal digits) is coded, the second character defaults to binary zeroes. 

(For information on 3101 PF key sequences, refer to IBM 3101 Display 
Terminal Description, GA18-2033.) 

For terminals other than the 3101 Display Terminal, the ASCII default is X'lB' 
(the ESC key). The EBASC default is X'D8'. 
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ACCA-Type Terminals (continued! 






PFl = The two-digit hexadecimal character which you want the system to interpret as 

PF key 1. The system interprets successive values as PF2 and pf3. 

For the 3101 Display Terminal, defaults are Usted in "Examples and Defaults" 
on page IS-223. 

For the 3101 Display Terminal in either character or block mode, the system 
defines the PFi key as the default PFl key. If you do not want the system 
default, specify two characters (four hexadecimal digits) representing the first 
and second characters of a 3101 PF key sequence. The system interprets 
successive characters as pf2, pf3, .... PF8. If you code only one character (two 
hexadecimal digits), the system makes the second character binary zeroes. 

For a 3101 Display Terminal attached via a 1610 controller or a 2091 controller 
with a 2092 adapter, use mirror image. 

The PFl ASCII default is 1B61; the ebasc default is D886. 

SCREEN = YES or ROLL, for screens that are to be operated similar to a typewriter. For 
screen devices that are attached through the teletypewriter adapter, when the 
screen is full, you must press the enter key for the output to continue. 

NO, for hard-copy devices. For 3101 display devices, when the screen fills up, 
you do not have to press enter for the output to continue. 

STATIC, for a full-screen mode of operation. STATIC is vaUd only for the 3101 
Display Terminal in block mode. 

Note: The initial terminal definition should be STATIC only if the terminal is 
reserved for data display and data entry operations. Normal system operations, 
such as those directed to $SYSLOG or those involving the utility programs, assume 
a roll screen configuration. The application program can define the static screen 
configuration by means of the ENQT and lOCB instructions described in the 
Language Reference. 



Appendix A. System Definition Statements IS-221 



TERMINAL -ACCA 
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PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 

You can change the partition assignment at execution time with the $CP operator 
command described in Operation Guide. 

TIMERS = The ACCA Ti and T2 values for receive and transmit operations in a sublist 

format. The timer defaults depend on the lmode specified. For local and 
RS-422, the defaults are 1,1,1,1. For pttopt, the defaults are 2,2,10,2 and for 
SWITCHED, they are 2,2,10,300. For example, timers= (4,5,6,7) specifies: 

Receive Tl =4 

Receive T2 =5 

Transmit Tl =6 

Transmit T2 =7. 

SPOOL= YES, to define terminal as a valid spoolable device. 

NO (the default), to specify terminal is not a valid spoolable device. However, 
the spoolable characteristics of the terminal can be redefined at a later time using 
the STERMUTl utility. 

END= YES, for the last terminal statement in a system definition module. The 

default is end=no. 
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ACCA-Type Terminals (continued) 



Examples and Defaults 



Default values for optional parameters on the terminal statement vary with the device type. In 
the following examples, the default assignments for each device support are shown as if they 
were expUcitly coded in the TERMINAL statement. If an operand is not shown, then it is not 
relevant for the device. Address assignments are for illustration only. 



Example 1: ascii terminal via 1610 controller terminal statement. 



label TERMINAL DEVICE=ACCA, ADDRESS=70,PAGSIZE=35, C 

LINSIZE=80 , C0DTYPE=EBASC , TOPM=0 , BOTM=34 , C 

LEFTM=0 , RIGHTM=79 , SCREEN=NO , OVFLINE=NO , C 

CRDELAY=0,BITRATE=300,RANGE=HIGH, C 
LM0DE=PTT0PT , ATTN=YES , ADAPTER=S INGLE , LF=50 , C 

CHARDEL= 1 , LINEDEL=FE , CR=BO , PART= 1 , C 
TIMERS= (2,2,10,2), SPOOL=NO , END=NO 






The following examples contain the required operands and the default values for defining the 
3101 Display Terminal. Address assignments are for illustration only. The default values 
require that you set space parity in the parity bit selection setup switches. (Refer to Appendix 
C, "3101 Configuration Information" on page IS-249 and IBM 3101 Display Terminal 
Description, GAl 8-2033 information on switch settings.) 

Example 2: IBM 3101 in character mode (connected with 1610 single-line controller or 2091 
eight-line controller with 2092 four-line adapter). 



label TERMINAL DEVICE=ACCA,ADDRESS=08 ,M0DE=31 01 C 

is equivalent to: 



label TERMINAL DEVICE=ACCA, ADDRESS=08 ,M0DE=31 01C, 

PAGSIZE=35 , LINSIZE=80 , CODTYPE=EBASC , TOPM=0 , 
B0TM=34 , LEFTM=0 , RIGHTM=79 , SCREEN=NO , NHIST=0 , 
OVFLINE=NO , CRDELAY=0 , BITRATE=300 , RANGE=HIGH , 
LMODE=PTTOPT , ATTN=D8 1 6 , ADAPTER=S INGLE , LF=50 , 
CHARDEL= 1 , LINEDEL=FE , CR=BO , PF 1 =D886 , 
TIMERS= (2,2,10,2), SPOOL=NO 
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Example 3: IBM 3101 in block mode (connected with 1610 single-line controller or 2091 
eight-line controller with 2092 four-line adapter). 



label TERMINAL DEVICE=ACCA, ADDRESS=68 ,M0DE=31 01B 

is equivalent to: 



label TERMINAL DEVICE=ACCA, ADDRESS=68 ,M0DE=3 1 01B,PAGSIZE=24, 
LINSIZE=80 , CODTYPE=EBASC , TOPM=0 , BOTM=23 , LEFTM=0 , 
RIGHTM=79 , SCREEN=ROLL , NHIST=0 , OVFLINE=NO , 
CRDELAY=0 , BITRATE=300 , RANGE=HIGH , LMODE=PTTOPT , 
ATTN=D8 1 6 , ADAPTER=S INGLE , LF=50 , CR=BO , PF 1 =D886 , 
TIMERS= (2,2,10,2) , SPOOL=NO 



Note: When DEVICE=ACCA and you code the mode operand, the system assumes additional 
defaults relevant to the 3101 Display Terminal. 

The following two examples contain sample values for defining the 3101 Display Terminal when 
it is connected with the 2095 controller and 2096 adapter. These examples are intended to 
guide you in coding your TERMINAL statements. 

The values shown require that you set space parity in the parity bit selection setup switches 
(refer to the IBM 3101 Display Terminal Description, GA 18-2033, for information on switch 
settings). See Appendix C, "3101 Configuration Information" on page IS-249 for 
recommended switch settings for the 3101 Display Terminal. Address assignments are for 
illustration only. 

Example 4: IBM 3101 in character mode (connected with 2095 eight-line controller and 2096 
four-line adapter). 



w 



label TERMINAL DEVICE=ACCA, ADDRESS=60 ,M0DE=3 1 01C, C 

PAGSIZE=35 , LINSIZE=80 , CODTYPE=ASCII , TOPM=0 , C 

BOTM=34 , LEFTM=0 , RIGHTM=79 , SCREEN=NO , NHIST=0 , C 

OVFLINE=NO , CRDELAY=0 , BITRATE=300 , RANGE=HIGH , C 

LMODE=PTTOPT , ATTN= 1 B68 , ADAPTER=FOUR , LF=OA , C 

CHARDEL=08 , LINEDEL=7F , CR=OD , PF 1 = 1 B6 1 , C 
TIMERS^ (2,2,10,2), SPOOL=NO 



c 
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ACCA-Type Terminals (continued) 



Example 5: IBM 3101 in block mode (connected with 2095 eight-line controller and 2096 
four-line adapter). 



label TERMINAL DEVICE=ACCA, ADDRESS=61 ,M0DE=3 1 OIB, C 

PAGSIZE=24 , LINSIZE=80 , CODTYPE=ASCII , C 

TOPM=0 , B0TM=2 3 , LEFTM=0 , RIGHTM=79 , C 

SCREEN=ROLL , NHIST=0 , OVFLINE=NO , CRDELAY=0 , C 

BITRATE=300 , RANGE=HIGH , LMODE=PTTOPT , C 

ATTN=1B68,ADAPTER=FOUR,LF=OA,CR=OD,PF1=1B61 , C 
TIMERS= (2,2,10,2), SPOOL=NO 



The following two examples contain sample values for defining the 3101 Display Terminal when 
it is connected with the #1310 adapter. These examples are intended to guide you in coding 
your TERMINAL Statement. 



Example 6: IBM 3101 in character mode (connected to a #1310 (mfa) base address). 



^ 



label TERMINAL DEVICE=ACCA, ADDRESS=58 ,M0DE=31 OIC, C 

PAGSIZE=35 , LINSIZE=80 , CODTYPE=ASCII , C 

TOPM=0 , BOTM=34 , LEFTM=0 , RIGHTM=79 , C 

SCREEN=ROLL , NHIST=0 , OVFLINE=NO , CRDELAY=0 , C 

BITRATE= 1200, LMODE=PTTOPT , ATTN= 1 B68 , LF=OA , C 

CHARDEL=08,LINEDEL=7F,CR=0D,PF1=1B61 , C 

ADAPTER=MFA , PART= 1 , TIMERS= (2,2,10,2), C 
SPOOL=NO , END=NO 



Example 7: IBM 3101 in block mode (connected to a #1310 (mfa) that is not the base 
address). 



label TERMINAL DEVICE=ACCA, ADDRESS=59 ,M0DE=3 1 OIB, 
PAGSIZE=24 , LINSIZE=80 , CODTYPE=ASCII , 
TOPM=0 , BOTM=23 , LEFTM=0 , RIGHTM=79 , 
SCREEN=ROLL , NHIST=0 , OVFLINE=NO , CRDELAY=0 , 
BITRATE=1200,LMODE=RS422,ATTN=1B68,LF=OA, 
CR=OD , PF 1 = 1 B6 1 , ADAPTER=MFA , 
TIMERS= (1,1,1,1), SPOOL=NO , END=NO 
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Example 8: The following example contains sample values for defining the 497 5 -01 A Printer 
when it is connected via the Feature Programmable Attachment (2095/2096). You must code 
ADAPTER^MFA if you use MFA to attach a 4975-01 A Printer. 



label TERMINAL DEVICE=ACCA, ADDRESS=61 ,BITRATE=1 200, 

LMODE=PTTOPT , ADAPTER=FOUR , T0PM=3 , BOTM=62 , 
LINSIZE= 132, RANGE=HIGH , CODTYPE=ASCII , 
PAGSIZE=66,MODE=4975-01A,COD=(1 1 , 13, IB) , 
TIMERS=(12,2,5,2) 



The Remote Support Link 



The following examples contain the required operands for defining the Remote Support Link for 
the four different types of attachments. You must define the Remote Support Link as an ACCA 
terminal on a switched line. (Refer to the Problem Determination Guide for information on using 
the Remote Support Link.) 



Example 9: With a 1610 attachment. 



label TERMINAL DEVICE=ACCA, ADDRESS=08 , BITRATE=1 200 , C 

LMODE=SWITCHED , AD APTER=S INGLE , PF 1 =D886 , C 

CODTYPE=EBASC , ATTN=D8 1 6 , PAGSIZE=24 , PART=3 , C 
SCREEN=YES 






Example 10: With a 2095/2096 attachment. 



label TERMINAL DEVICE=ACCA, ADDRESS=70 ,BITRATE=1 200, C 

LM0DE=SWITCHED,ADAPTER=F0UR,PF1=1B61 , C 

CODTYPE=ASCII , ATTN= 1 B68 , PAGSIZE=24 , PART=3 , C 
SCREEN=YES 



Example 71: With an MFA attachment. 



label TERMINAL DEVICE=ACCA, ADDRESS=58 ,BITRATE=1 200 , C 

LMODE=SWITCHED , ADAPTER=MFA , PF 1 = 1 B6 1 , C 

CODTYPE=ASCII , ATTN= 1 B68 , PAGSIZE=24 , PART=3 , C 
SCREEN=YES 



m ir 
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ACCA-Type Terminals (continued) 



Example 12: With a 2091/2092 attachment. 



label TERMINAL DEVICE=ACCA, ADDRESS=70 ,BITRATE=1 200 , C 

LMODE=SWITCHED , ADAPTER=FOUR, PF 1 =D886 , C 

CODTYPE=EBASC , ATTN=D8 1 6 , PAGSIZE=24 , PART=3 , C 
SCREEN=YES 



\. 
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TTY-Type Terminals 



A TERMINAL definition statement with DEVICE=tty locally attaches teletypewriter terminals and 
IBM 3101 Display Terminals to the Series/ 1 through the Teletypewriter Attachment (feature 
#7850). Its most frequent use is in transferring ASCII character strings between the Series/ 1 and 
a teletypewriter terminal. The most common types of such terminals are keyboard/printer and 
keyboard/CRT devices. 

Devices that may be compatible with the physical transmission methods of the Series/ 1 
Teletypewriter Adapter are available from many vendors; these include Isolated Contact sense, 
TTL, and EIA. Such devices include terminals that transmit only, or receive only, or transmit only 
in response to being polled. The devices may not have keyboards for input but may acquire data 
from bar code scanners or analog or digital input features within the device. The transmission 
code used by these devices can be alphameric ASCII or any of the 256 possible 8-bit character 
combinations. 



Syntax: 



label TERMINAL DEVICE= ADDRESS= IVIODE= PAGSIZE= CODTYPE= 

LINSIZE=TOPM=BOTM= LEFTM,RIGHTM=OVFLINE= 
LINEDEL=CHARDEL=CRDELAY= ECHO=CR= 
LF=ATTN=PF1=SCREEN=PART=SP00L=END= 

Required: DEVICE= ADDRESS= 

Defaults: OVFLINE=NO,ECHO=YES,CR=0D,LF=0A,ATTN=YES, 
SP00L=N0,PART=1,END=N0 



^J 



Operand Description 

DEVICE = TTY, a 3 101 Display Terminal in character mode or another ASCII Terminal 
attached via Teletypewriter Adapter (7850) 

ADDRESS= The address (in hexadecimal) of the device. 

MODE= 3101C, for a 3101 Display Terminal that operates in character mode. 

PAGSIZE= The physical page size (form length) of the I/O medium. Specify a decimal 

number between 1 and the maximum value which is meaningful for the device. 

CODTYPE= The transmission code used by the terminal; in this case, C0DTYPE= must equal 

ASCII. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. 

TOPM= The top margin (a decimal number between zero and pagsize-i) to indicate the 

top of the logical page within the physical page for the device. 
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TTY-Type Terminals (continued) 



BOTM= The bottom margin, the last usable line on a page. Its value must be between 

TOPM+NHIST and PAGSiZE-i. If an output instruction would cause the line 
number to increase beyond this value, then a page eject, or wrap to line zero, is 
performed before the operation is continued. 

LEFTM= The left margin, the character position at which input or output will begin. 
Specify a decimal value between zero and LINSIZE-I. 

RIGHTM= A value (between leftm and LiNSlZE-i) that determines the last usable character 
position within a line. Position numbering begins at zero. 

OVFLINE= YES, if output Unes which exceed the right margin are to be continued on the 
next line. The default is ovfline=no. 

The overflow condition occurs when the system buffer (or a buffer in an 
application program) becomes full and the application program has taken no 
action to write the buffer to the device. 

LINEDEL= A two-digit hexadecimal character that defines the character the operator will 
enter when he wishes to restart an input line. In some cases, input of this 
character causes a repeat of the previous output message. Refer to "ASCII 
Transmission Codes" on page IS- 184. 






CHARDEL= A two-digit hexadecimal character which indicates deletion of the previous input 
character. It is meaningful only for devices whose mode of transmission is one 
character at a time, as described in the linedel operand. 



For further information on how to code this operand for ASCII terminals, refer to 
"ASCII Transmission Codes" on page IS- 184. 

Note: When CHARDEL= and linedel= values are equal, no translation or 
editing will occur. 

CRDELAY= The number of idle times required for a carriage return to complete for 

teletypewriter devices. If printing occurs during the carriage return, crdelay is 
too small. 

ECHO= NO, for devices that do not require input characters to be written back (echoed) 

by the processor for printing, 

YES (the default) is appropriate for most devices connected through the 
teletypewriter adapter. See the lf parameter description regarding suppression 
of the echo of the CR character. 
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CR= The character to be tested to determine if a new line function is to be performed. 

The default is CR=OD. 

For further information on how to code this operand for ASCII terminals, refer to 
"ASCII Transmission Codes" on page IS- 184. 

LF= The character to be sent to the terminal when a new line function is to be 

performed. If the same value is coded for LF= as was coded (or defaulted) for 
CR= then the CR character which terminates an input operation will not be 
echoed to the terminal; the terminal is assumed to be an auto line-feed device. 
The default is lf=oa. 

For further information on how to code this operand for ASCII terminals, refer 
to "ASCII Transmission Codes" on page IS- 184. 

ATTN= NO, if the attention key and the PF keys are to be disabled for the terminal. 

Such disabling is then permanent for the generated system. 

YES (the default) or ALL, if all attention functions are to be enabled for the 
terminal. 

LOCAL, to limit the attention functions to those defined by ATTNLISTs within 
programs loaded from the terminal. 

NOSYS, to exclude only the system functions ($L, $C, and so forth). [ J 

NOGLOB, to exclude only the global ATTNLIST functions. (GLOBAL is the 
ATTNLIST of all programs in the same partition at one time.) 

Note: This operand can also be entered with a two-digit hexadecimal character 
for the attention key if the system default is not desired. 

The attention key can be redefined with a two-digit hexadecimal character for 
ASCII terminals. 

For the 3101 Display Terminal in character mode, the system defines the PF8 
key as the default attention key. If you do not want the system default, specify 
two characters (four hexadecimal digits) representing the first and second 
characters of a 3101 PF key sequence. If only one character (two hexadecimal 
digits) is coded, the second character defaults to binary zeroes. 

Note: The attention key must be uniquely defined so that the hexadecimal digits 
cannot be returned as the response to a readtext statement. If the key is not 
uniquely defined, the attention routine is entered erroneously. 



\J 
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TTY-Type Terminals (continued) 



(For more information on modifying the default attention key, refer to the 
description of $TERMUT2 utiUty in Operator Commands and Utilities Reference. 
For information on 3101 PF key sequences, refer to IBM 3101 Display Terminal 
Description, GA 18-203 3.) 

PFl = The two-digit hexadecimal character which you want the system to interpret as 

PF key 1. The system interprets successive values as pf2 and pf3. 

For the 3101 Display Terminal, defaults are Usted in "Examples and Defaults" 
on page IS-232. 

For the 3101 Display Terminal in character mode, the system defines the pfi key 
as the default pfi key. If you do not want the system default, specify two 
characters (four hexadecimal digits) representing the first and second characters 
of a 3101 PF key sequence. The system interprets successive characters as PF2, 
PF3, .... PF8. If you code only one character (two hexadecimal digits), the system 
makes the second character binary zeroes. 



SCREEN = YES or ROLL, for screens that are to be operated similar to a typewriter. For 
screen devices that are attached through the teletypewriter adapter, when the 
screen is full, you must press the enter key for the output to continue. 

NO, for 3101 display devices. When the screen fills up, you do not have to press 
enter for the output to continue. 

PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 



You can change the partition assignment at execution time with the $CP operator 
command described in Operation Guide. 

SPOOL= YES, to define terminal as a vaUd spoolable device. 

NO (the default), to specify terminal is not a valid spoolable device. However, 
the spoolable characteristics of the terminal can be redefined at a later time using 
the $TERMUT1 utiUty. 

END= YES, for the last terminal statement in a system definition module. The 

default is end=no. 
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TTY-Type Tenninals (continued) 



Examples and Defaults 



In the following examples, the default assignments for device=tty are shown as if they were 
explicitly coded in the terminal statement. If an operand is not shown, then it is not relevant 
for the device. Address assignments are for illustration only. 

Example 1 : ASCii terminal via 7850 adapter terminal statement. 



label TERMINAL DEVICE^TTY, ADDRESS=00 ,PAGSIZE=35 ,LINSIZE=80 , C 

CODTYPE=ASCII , TOPM=0 , BOTM=34 , LEFTM=0 , RIGHTM=79 , C 

SCREEN=NO , OVFLINE=NO , LINEDEL=7F , CHARDEL=08 , C 
CRDELAY=0 , ECHO=YES , ATTN=YES , CR=OD , LF=OA , SPOOL=NO 



The following example contains the required operands and the default values for defining the 
3101 Display Terminal in character mode. The default values require that you set space parity 
in the parity bit selection setup switches. (Refer to IBM 3101 Display Terminal Description, 
GA18-2033 and Appendix C, "3101 Configuration Information" on page IS-249 for 
information on switch settings.) 

Example 2: IBM 3101 in character mode (connected with 7850 teletypewriter adapter). 



label TERMINAL DEVICE=TTY, ADDRESS=00 ,M0DE=31 01C 

is equivalent to: 



label TERMINAL DEVICE=TTY, ADDRESS=00 ,M0DE=31 01C,PAGSIZE=35 , 
LINSIZE-80 , CODTYPE=ASCII , TOPM=0 , BOTM=34 , 
LEFTM=0 , RIGHTM=79 , SCREEN=NO , NHIST=0 , OVFLINE=NO , 
LINEDEL=7F , CHARDEL=08 , CRDELAY=0 , ECHO=YES , 
ATTN= 1 B68 , CR=OD , LF=OA , PF 1 = 1 B6 1 , SPOOL=NO 



\J 



Note: When device=tty, if you code the MODE operand, the system assumes additional 
defaults relevant to the 3101 Display Terminal. 
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Processor-to-Processor 



A TERMINAL definition statement with DEVlCE=PROC is used when the Series/ 1 is to 
communicate with another processor. The Asynchronous Communication Single Line 
Controller (feature #1610) is the feature used. This allows connecting Series/ 1-to-Series/l, or 
Series/ 1 to any other processor capable of handling the required protocols. As with terminals, 
ATTENTION signals can be transmitted. 

If cODTYPE=EBCDic is defined on the terminal statement, arbitrary binary data can be 
transmitted. Set the bitrate and range parameters in accordance with the hardware jumpers, 
matching the setting in the other processor. Also, the linsize parameter must have the same 
value in both processors. 

The transmission protocol can be modified to satisfy special requirements by assigning the 
appropriate values to the crdelay and CODTYPE operands. 



Syntax: 






label 



Required: 
Defaults: 



TERMINAL DEVICE= ADDRESS= CODTYPE= 
LINSIZE=CRDELAY=BITRATE= 
CR= LF= RANGE= END= 

DEVICE=ADDRESS= 

CODTYPE=EBCDIC,LINSIZE=130,CRDELAY=(PROMPT,30000), 

BITRATE=9600,RANGE=HIGH,CR=5B,LF=5B,END=NO 



Operand Description 

DEVICE= PROC, processor-to-processor communication. 

ADDRESS = The address (in hexadecimal) of the device. 

CODTYPE= The transmission code used by the terminal. Specify either CRSP, EBCD, or 
EBCDIC as follows. The defauh is codtype=ebcdic. 

CRSP With this option, the #1610 controller is set to PTTC mode (see 

Communications Feature Description) and messages are translated 
using the CRSP conversion table (PTTC/correspondence code). The 
communication is restricted to characters, as PTTC mode allows 
only the transmission of bytes with the seven low-order bits of odd 
parity. Therefore, XLATE=NO should not be specified on printext 
or READTEXT instructions. 
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EBCD The effect of coding this option is similar to CRSP, except that the 

EBCD conversion table is used. The EBCD option is recommended 
for connection to an IBM 5 100 or 5 110 computer. The 6-bit code 
must be selected with the Serial I/O feature. 

EBCDIC This option sets the #1610 controller to Eight Bit Coded Data 
Interchange mode with all change of direction codes equal to 
X'FF' (see the Communications Feature Description). Special 
protocol provides for transparent exchange of arbitrary binary 
data. As there are no parity restrictions and only the code X'FF' is 
recognized as change of direction (indicating EOT, NL or EOSR), all 
bytes (especially all EBCDIC characters) other than X'FF' are 
transmitted "as is." Before a message or record is sent, it is 
scanned for a byte code (other than X'FF') not contained in it. 
This special code is sent as EOA and every occurring X'FF' in the 
message or record is replaced by it. On the receiving side, every 
EOA code is replaced by X'FF'. If a record is larger than 128 
bytes, it is divided into appropriate subrecords (length < 128 
bytes) to which the procedure can be applied. 



LINSIZE= The maximum length of an input or output line for the device. The value of this 

operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is linsize=130. 

CRDELAY= The number of idle times required for a carriage return to complete for 

teletypewriter devices. If printing occurs during the carriage return, CRDELAY 
is too small. The default is crdelay=prompt,30000. 



W 



PROMPT,n The device support waits before every record (and subrecord) 
for the EOT prompt character. The time limit is n times 3.33 
milliseconds, starting at the end of the previous operation. In 
response to the EOT, and also at the beginning of every record 
(and subrecord), an EOA character is sent. 

SP5100,n The effect of coding this option is identical to the prompt 

mode except that at End of Record, the two characters Line 
Feed and New Line (X'3B5B') are sent. This is necessary for 
communication with the IBM 5 100 or 5 1 10 running APL or 
basic and using the Serial I/O feature. 

DELAY,n At the beginning of a message, the device support waits a 

maximum of one second for the EOT character (s). After each 
record, a delay of n times 3.33 miUiseconds is inserted. This 
mode might be used to simulate an 2741 -like terminal for 
another processor. 
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BITRATE= 



Note: When chardel= and linedel= values are equal, no translation or 
editing will occur. 

The rate (in bits per second) that this terminal will be operating. The default is 

BITRATE=9600. 



RANGE= Enter HIGH or LOW to match hardware jumper that is installed on the adapter 

card. The default is range=high. 



CR= 



LF= 



The character to be tested to determine if a new line function is to be 
performed. 

The default is CR=5B. 

The character to be sent to the terminal when a new line function is to be 
performed. If the same value is coded for LF= as was coded (or defaulted) for 
CR= then the CR character which terminates an input operation will not be 
echoed to the terminal; the terminal is assumed to be an auto line-feed device. 

The default is lf=5B. 






END= 



Example and Defaults 



YES, for the last terminal statement in a system definition module. The 
default is end=no. 



In the following example, the default assignments for device=PROC are shown as if they were 
explicitly coded in the terminal statement. If an operand is not shown, then it is not relevant 
for this support. Address assignment is for illustration only. 

Example: Defining processor-to-processor communications through the 1610 controller. 



label TERMINAL DEVICE=PROC, ADDRESS=7F 

is equivalent to: 



label terminal DEVICE=PR0C, ADDRESS=7F,C0DTYPE=EBCDIC, 

LINSIZE=130,CRDELAY= (PROMPT, 30000) ,BITRATE=9600 , 
RANGE=HIGH , CR=5B , LF=5B , END=NO 
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Interprogram Communication - Virtual Tenninals 



A TERMINAL definition statement with device=virt defines interprogram communication. 
Refer to the Event Driven Executive Language Programming Guide for a description of virtual 
terminals. 



Syntax: 



label 



Required; 
Defaults: 



TERMINAL DEVICE= ADDRESS= LINSIZE= 
SYNC=END= 

DEVICE=ADDRESS= 
LINSIZE=80,SYNC=NO,END=NO 



Operand Description 

DEVICE= VIRT for interprogram communication. 

ADDRESS^ The label of the other virtual terminal. 



UNSIZE= 



SYNC= 



END= 



The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is LINSIZE=80. 

YES, if synchronization events will be posted to this virtual terminal. Attempted 
actions over the virtual channel are indicated in the task control word. YES 
allows two terminals to synchronize their actions so that when one terminal is 
writing, the other is reading. 

NO, if you do not want synchronization events posted. NO is the default. 

YES, for the last terminal statement in a system definition module. The 
default is end=no. 



o 
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Interprogram Communication - Virtual Temiinals (continued) 

Examples and Defaults 

In the following examples, the default assignments for device=virt are shown as if they were 
explicitly coded in the terminal statement. If a parameter is not shown, then it is not relevant 
for the device. Address assignments are for illustration only. 

Example 1 : Remote Management Utility using the passthru function - terminal 
statements. 



Note: This example shows a line size of 80. The maximum line size value is 254. The names 
CDRVTA and CDRVTB are required. 



CDRVTA TERMINAL DEVICE=VIRT, ADDRESS=CDRVTB, SYNC=YES 
CDRVTB TERMINAL DEVICE=VIRT, ADDRESS=CDRVTA 
is equivalent to: 



CDRVTA TERMINAL DEVICE^VIRT , ADDRESS=CDRVTB , S YNC^YES , 
LINSIZE=80 , END=NO 

CDRVTB TERMINAL DEVICE=VIRT, ADDRESS=CDRVTA, SYNC=NO, 
LINSIZE=80 , END=NO 



Example 2: Virtual terminal terminal statements. 



AAA TERMINAL 


DEVICE=VIRT , ADDRESS=BBB , SYNC=YES 




BBB TERMINAL 


DEVICE=VIRT , ADDRESS=AAA 




is equivalent to: 






AAA TERMINAL 


DEVICE=VIRT , ADDRESS=BBB , LINSIZE=80 , 


C 


SYNC= 


=YES , END=NO 




BBB TERMINAL 


DEVICE^VIRT , ADDRESS=AAA , LINSIZE=80 , 


C 


SYNC 


=N0 , END=NO 
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General Purpose Interface Bus 



A TERMINAL definition statement with device=gpib defines a General Purpose Interface Bus 
(gpib). Refer to Communications Guide for a description of GPIB, 

Syntax: 



label 



Required: 
Defaults: 



TERMINAL DEViCE=,ADDRESS= LINSIZE= CODTYPE= 
ATTN=SCREEN= PART=SPOOL=END= 

DEVICE=ADDRESS= 

CODTYPE=ASCII,LINSIZE=80,ATTN=YES,SCREEN=NO, 

PART=1,SP00L=N0,END=N0 



Operand Description 

DEVICE= GPIB, General Purpose Interface Bus (gpib). 

ADDRESS= The address (in hexadecimal) of the device. 

CODTYPE= The transmission code used by the terminal. In this case, specify ASCII. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is LINSIZE=80. 

ATTN= NO, if the attention key and the PF keys are to be disabled for the terminal. 

Such disabling is then permanent for the generated system. If you do not specify 
ATTN=, the default is attn=yes. 

YES or ALL, if all attention functions are to be enabled for the terminal. 

LOCAL, to limit the attention functions to those defined by ATTNLISTs within 
programs loaded from the terminal. 

NOSYS, to exclude only the system functions ($L, $C, and so forth). 

NOGLOB, to exclude only the global attnlist functions. (GLOBAL is the 
ATTNLIST of all programs in the same partition at one time.) 

Note: This operand can also be entered with a two-digit hexadecimal character 
for the attention key if the system default is not desired. 

The attention key can be redefined with a two-digit hexadecimal character for 
ASCII terminals. 

For ASCII terminals other than the 3101 Display Terminal, the default is ASCII 
X'lB' (the ESC key). The mirror image of X'lB' is X'D8'. 



o 



o 



IS-238 SC34^646 



TERMINAL -GPIB 



%J 



General Purpose Interface Bus (continued) 

Note: If the terminal being defined is specified in tlie hdcopy= parameter of 
another terminal, do not code attn=no. 

SCREEN = YES or ROLL, for screens that are to be operated similar to a typewriter. For 
screen devices that are attached through the teletypewriter adapter, when the 
screen is full, you must press the enter key for the output to continue. 

NO (the default), for hard-copy devices. When the screen fills up, you do not 
have to press enter for the output to continue. 

PART= The partition (1—8) with which the terminal is normally associated. The default 

is partition 1 . 

You can change the partition assignment at execution time with the $CP operator 
command described in Operation Guide. 

SPOOL= YES, to define terminal as a valid spoolable device. 

NO (the default), to specify terminal is not a valid spoolable device. However, 
the spoolable characteristics of the terminal can be redefined at a later time using 
the $TERMUT1 utility. 






END= 



Example and Defaults 



YES, for the last terminal statement in a system definition module. The 
default is end=no. 



In the following example, the default assignments for device=gpib are shown as if they were 
explicitly coded in the terminal statement. If an operand is not shown, then it is not relevant 
for the device. Address assignment is for illustration only. 

Example: General Purpose Interface Bus (GPIB) terminal statement. 



label TERMINAL DEVICE=GPIB, ADDRESS=25 

is equivalent to: 



label terminal DEVICE=GPIB,ADDRESS=25 ,LINSIZE=80, 

CODTYPE=ASCI I , SCREEN=NO , ATTN=YES , PART= 1 , 
SP00L=N0,END=N0 
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Series/1 -to-Series/1 



A TERMINAL definition statement with DEVICE=S1S1 defines the Series/ l-to-Series/l 
Attachment (RPQ D02241 or D02242). Refer to Communications Guide for a description of the 
attachment. 

Syntax: 



label 



Required: 
Defaults: 



TERMINAL DEVICE=,ADDRESS= LINSIZE= 
CHKSUIVI=END= 

DEVICE=ADDRESS= 
LINSIZE=80,CHKSUM=16,END=NO 



Operand Description 

DEVICE= SlSl, Series/ 1 -to-Series/1 Attachment (rpq D02241 or D02242). 

ADDRESS= The address (in hexadecimal) of the device. 

LINSIZE= The maximum length of an input or output line for the device. The value of this 
operand can be less than the maximum which the device can accommodate, but 
the value cannot be increased dynamically. The default is LINSIZE=80. 

CHKSUM= The number of data bytes from which you wish the system to generate a 
checksum total when the Series/ 1 -to-Series/1 Attachment performs data 
transfer. Specify if you do not want the system to perform error detection. 
Specify 2, 4, 8, 16, or 32 if you want error detection. 

The default is CHKSUM=16. 

Note: If you specify error detection, the data transfer rate is affected. 

END= YES, for the last terminal statement in a system definition module. The 

default is end=no. 



\- J 
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Series/1 -to-Series/1 (continued) 



Example and Defaults 



In the following example, the default assignments for DEVICE=S1S1 are shown as if they were 
explicitly coded in the TERMINAL statement. If an operand is not shown, then it is not relevant 
for the device. Address assignment is for illustration only. 

Example: Series/ 1 -to-Series/1 TERMINAL statement. 



label TERMINAL DEVICE=S1 SI , ADDRESS=25 

is equivalent to: 



label TERMINAL DEVICE=S1 SI , ADDRESS=25 ,LINSIZE=80 , 
CHKSUM= 1 6 , END=NO 
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TIMER - Define System Timer Features 

TIMER defines the #7840 Timer Feature to be used as the system timers in the generated system. 
There are two timers on the #7840 Timer feature card. One is used for time of day recording 
and the other is used for interval timing. Only one TIMER statement is required to define both 
timers. When you list out the devices supported by your operating system using $lOTEST (LS), 
two timers are shown. 

This statement is used only for defining the #7840 timer. If the system has a native timer (4954 
and 4956 processors) that is used instead of the #7840 timer feature card, it is not necessary to 
use this or any other statement. The native timer and the #7840 timer are mutually exclusive. 

Syntax: 



blank 

Required: 
Defaults: 



TIMER 

ADDRESS= 
None 



ADDRESS= 



Operand Description 

ADDRESS= The hexadecimal address of the #7840 Timer Feature. 

Example: Both timers are defined by a single timer definition statement. 



TIMER 



ADDRESS=40 



(f 

u 



,^ 
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Appendix B. Customizing Adapters with 

Hardware Jumpers 



Each hardware feature has hardware jumpers that are used to customize it. You need to become 
f amiUar with these jumpers in order to configure the hardware for your system correctly. Before 
you actually connect terminals and modems, also refer to IBM Series/ 1 Communications 
\ Feature Description, GA34-0028. If your terminal configuration includes the IBM 3101 Display 

^'^ Terminal, see both Appendix C, "3101 Configuration Information" on page IS-249 andlBM 

3101 Display Terminal Description, GA 18-2033. 

After you have customized the hardware features properly, you must define the terminals to the 
Event Driven Executive system using the terminal statement; see Appendix A, "System 
Definition Statements" on page IS- 145. 



ACCA Adapters 



Each ACCA adapter feature has hardware jumpers that you use to customize it. Be sure the 
hardware is configured correctly prior to defining the software interface. 

For information on customizing adapters for use with the 3101 Display Terminal, see Appendix 
C, "3101 Configuration Information." 
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Customizing Adapters with Hardware Jumpers 

ACCA Adapters (continued) 

Some general rules for hardware jumpers are: 

• For direct connect terminals: 

- You usually should jumper Data Terminal Ready (dtr) 

- You usually should jumper Request to Send (RTS) 

- You should jumper Carrier Detect (CD) only when the terminal provides Request to 
Send (RTS). 

• For leased lines using modems: 

- You jumper Data Terminal Ready (dtr) only when Event Driven Executive application 
programs do not control the modem 

- You jumper Request to Send (RTS) only if the modem provides a steady Clear to Send 
(CTS) signal 

- You jumper Carrier Detect (CD) only if the modem supports this feature. 

• For switched lines using modems: 

- You jumper Data Terminal Ready (dtr) only when Event Driven Executive application 
programs do not control the modem 

- You jumper Request to Send (rts) only if the modem provides a steady Clear to Send 
(CTS) signal 

- You jumper Carrier Detect (CD) only if the modem supports this feature. 

You should install speed range jumpers in accordance with instructions in the Communications 
Feature Description. 

The Multifunction Attachment (#1310) does not contain hardware jumpers for speed range, 
dtr, RTS or CD. The system makes required connections internally at IPL time according to the 
configuration for the terminal statement for the device. 
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Interprocessor Communications using #1610 Controller 



In addition to defining the #1610 controller to the Event Driven Executive with the TERMINAL 
statement, you should set the hardware jumpers on the attachment according to the IBM 
Series/ 1 Communications Feature Description, GA34-0028. 



For a direct processor interconnection: 

• You jumper Data Terminal Ready (dtr) 

• You jumper Request To Send (RTS) 

• You jumper Low or High speed range depending on the bit rate you choose (100 to 9600 
baud). 

Be sure to use the right cables for the type of attachments you are interconnecting. For a direct 
Series/ 1-to-Series/l connection, use the local Communication Cable (feature #2056) for one 
side and the EIA Data Set cable (feature #2057) for the other in order to interchange the 
Receive /Transmit lines: Data Set Ready (DSR)/Data Terminal Ready (dtr) and Request To 
Send (RTS)/Clear To Send (CTS). The #2056 cable allows attachment to a modem (male 25-pin 
type D connector); the #2057 cable allows attachment to a terminal (female 25 -pin type D 
connector). 






\ 



If only one cable type is available, you must cross the following lines of the 25-pin type D 
connectors: 



Pin number 


to 


Pin number 


(connector 1) 




(connector 2) 


1 


Protective Ground XMT 


1 


2 


Transmit Data (X or T) 


3 


3 


Receive Data (REC) 


2 


4 


Request to Send (RTS) 


5 


5 


Clear to Send (CTS) 


4 


6 


Data Set Ready (DSR) 


20 


7 


Signal Ground 


7 


20 


Data Terminal Ready (DTR) 


6 



For a Series/ 1-to-IBM 5100 connection, you may use the #2056 cable. 
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Customizing Adapters with Hardware Jumpers 

Terminals Connected Using Digital I/O #1560 

Terminal support is provided for digital I/O devices such as the Tektronix^ 4010 series of display 
terminals equipped with the General Purpose Parallel Interface (Tektronix Custom Feature 
Number CM021-0109-03; with cable: CMOl 2-054 l-oo) or terminals having equivalent hardware 
interfaces. The software provides addressing logic enabling up to eight terminals to be shared 
on one digital input group and one digital output group, with one process interrupt bit for each 
terminal. 



o 

yk^ 



The parallel interface is intended to connect directly to the integrated digital input/output 
feature (#1560) or the 4982 nonisolated digital input/output features. This interface consists of 
a driver and a receiver card, each of which has several selectable options. These options allow 
you to customize the interface to your requirements. You must refer to the manufacturer's 
manuals for detailed installation procedures. 



The following description is intended only to supplement the manufacturer's manuals and to 
guide you in the use of the Event Driven Executive terminal support on the Series/ 1. You 
should select the following options: 



Receiver Card 




INTR (interrupt) 


PROG 


ADDRESS 


000(0)-1 11(7) to match 




TERMINAL definition 


PERM ADD 


OFF 


PARITY 


EVEN 


DELAY 


3.5-18 (depends on distance) 


LOGIC SENSE (3) 


Set all to LOW 




HANDSHAKE 




CONTROL 




DATA 


THRESHOLD 


+2 volts 


MASTER OPTION 


None 



(f 



\J 



^ Trademark of Tektronix, Inc. 
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Terminals Connected Using Digital I/O #1560 (continued) 



Driver Card 




LOGIC SENSE (4) 


Set as shown 




STATUS HIGH 




HANDSHAKE HIGH 




INTERRUPT LOW 




DATA HIGH 


INTERRUPT CHANNEL 


Use INTR 


AUXTSUP 


OUT 


ECHO 


OUT 


PARITY 


EVEN, BIT 8 IN 




AB to A, CD to D 






Before you can use the terminal with the computer, some other considerations are necessary. As 
noted above, you must use the common interrupt line (intr). Select the interrupt line (0 — 7) 
corresponding to the terminal address. If you attach fewer than eight terminals, you will not use 
some of the interrupt lines. You must terminate all digital input and process interrupt lines for 
proper operation. If you use only one terminal, the manufacturer may have installed the Di 
terminations. With multiple terminals, you should terminate all Di and PI lines at the computer. 
A 1000-ohm resistor across the Di and Pi inputs is recommended. You must set the Baud Rate 
Selection Switch to the "stand by" position and the J261 Connector Switch to "interface." 

If you switch on the terminal and get no response, you will have to reset it. To do so, hold down 
the SHIFT and reset keys and switch the local/line switch to LOCAL then to line. 



Since all Event Driven Executive terminal input/output is done with upper-case ASCII character 
codes, you should activate the tty lock key when using the terminal with the Series/ 1. 

The last items for special discussion are the GIN mode and the page full break strap options 
on the terminal control card (TC-2). You should set the gin termination to none. Thus, when 
you use gin mode, you must press the appropriate key followed by the carriage return (cr). 
You n\ay set the PAGE FULL BREAK termination to either OUT or in, depending on your 
preference. If it is IN, the terminal will always stop when it reaches a full page condition. Then 
you must press the PAGE RESET key in order to continue. If it is OUT, the terminal will 
automatically go to the home address and continue printing without erasing the screen. 
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Customizing Adapters with Hardware Jumpers 

Multifunction Attachment (#1310) 

The Multifunction Attachment (mfa) is supported by both the EDX terminal support I/O 
instructions and the EDX BSCAM. 

The MFA card has four ports for connecting data communications equipment. You can connect 
the #1310 adapter to the following devices: 

• 3101Cor3101B display terminals 

• 4975 printers 

• a binary synchronous communications line. 

The use of the RS-232 interface with the 3101, 4975, or a BSC line requires that you connect the 
Une to Port 0. Port of the MFA can operate in either RS-232 or RS-422 interface mode. Ports 1, 
2, and 3 are limited to operations via the RS-422 interface. 

You may substitute the #1310 adapter for other asynchronous adapters subject to the limitations 
on the interface requirements and supported terminal types stated above. 



( 
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Appendix C. 3101 Configuration Information 



Connecting the 3101 to the Series/1 






The IBM 3101 Display Terminal is supported under the Event Driven Executive in both 
character and block mode. This appendix presents information to aid you in planning the link 
between the Series/ 1 and the 3101. 

The 3101 is connected to the Series/ 1 by the attachment features supported by the Event 
Driven Executive Version 4. For each attachment and type of interface, it is necessary to set 
the 3101 switches, have the attachment card physically jumpered, connect the cables, and 
specify the appropriate terminal statement (if applicable). 



With the exception of the #7850 Teletypewriter Adapter, you can use the attachment features 
with the 3101 in either character or block mode as follows: 



Feature 


Feature 
number 


Character 
mode 


Block 
mode 


Teletypewriter Adapter 


7850 


Yes 


No 


Multifunction Attachnnent 


1310 


Yes 


Yes 


Asynchronous Communications 
Single- Line Controller 


1610 


Yes 


Yes 


Asynchronous Communications 8- Line 
Controller with 4- Line Adapter 


2091/ 
2092 


Yes 


Yes 


Feature Programmable 8- Line Controller 
with 4- Line Adapter 


2095/ 
2096 


Yes 


Yes 



Figure 14. 3101 attachment features 
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Connecting the 3101 to the Series/1 (continued) 

For each of these attachment features, there are many 3101 configurations available. Refer to 
"Configuring Your 3101" on page IS-258 for sample configurations for each attachment card 
option, the cable connections, the 3101 switch settings, and the terminal statements for each 
interface/attachment. 

3101 Display Terminal in Character Mode 

You can connect the IBM 3101 Display Terminal (in character mode) to the Series/ 1 through 
five attachment features: 

#7850 teletypewriter adapter 

#1310 adapter 

#1610 controller 

#2091 controller with #2092 adapter 

#2095 controller with #2096 adapter. 

In the following discussion, all connections are direct with no intervening modem. For a 
discussion of leased and switched lines using modems, refer to Appendix B, "Customizing 
Adapters with Hardware Jumpers" on page IS-243. 
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Connecting the 3101 to the Series/1 (continued) 

Attachment via the #7850 Teletypewriter Adapter 

Switch settings: For attachment via the #7850 adapter with an EIA interface, you may set 
the 3101 setup switches as follows: 





Group 1 




1 2 3 4 5 6 7 8 


on 


X X 


off 


XX XXX X 



Group 2 

1 2 3 4 5 6 7 8 



Group 3 

12 3 4 5 6 7 8 



Group 4 

1 2 3 4 5 6 7 8 



XXXXXXXX 



X 




X 


X 












X 






X 


X 


X 


X 



X 






X 


X 






X 




X 


X 






X 


X 





Attachment options: The input selection jumpers for the #7850 with an EIA interface should 
be set to 010 indicating EIA with input interpreted as minus = data mark. In the switch settings 
above, the Group 4 3101 setup switch settings indicate a speed of 9600 bps. You must set the 
#7850 rate selection jumpers to 1 1 1 1 to indicate the same speed to the adapter. 

The switch settings and attachment options correspond to the configurations numbered 1 and 2 
in Figure 19 on page IS-261. 






Cable connections: Figure 15 shows the 3101 (character mode) attachment with the #7850 
teletypewriter adapter. 



EIA interface 



7850 
TTY 
Adapter 



Attachment cable 



7850 
TTY 
Adapter 



Feature code 2064 



Attachment cable 



Feature code 2065 



Current loop interface 



3101 
Terminal 



character 
mode 



3101 cable 



3101 
Terminal 



character 
mode 







3101 
Terminal 
Models 
12,22 only 


7850 
1 lY 
Adapter 


Attachment cable 


Feature code 2066* 







character 
mode 



' This cable is unmodified or modified According to the source 
of the transmit current. See Figure 1 9 on page IS-261 . 



Figure 15. 3101 Terminal with #7850 Adapter 
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Connecting the 3101 to the Series/1 (continued) 



Attachment via #1310, #1610, #2091 with #2092, or #2095 with #2096 

Switch settings: For attachment via the #1610 controller, the #2091 controller with #2092 
adapter, or the #2095 controller with #2096 adapter, you may set the 3101 setup switches as 
follows: 





Group 1 




Group 2 




Group 3 




Group 4 




12 3 4 5 6 7 8 




1 2 3 4 5 6 7 8 




12 3 4 5 6 7 8 




12 3 4 5 6 7 8 


on 


XXX X 








X XX 




X XX X 


off 


X XXX 




XXXXXXXX 




X X X X X 




XX XX 



These switch settings and "Attachment options:" on page IS-253 correspond to the 
configurations numbered 4, 5, and 6 in Figure 19 on page IS-261. 

The switch settings for the #1310 are the same except that switch 3 of group 1 must be in the 
"off" (rs-422) position if the 3101 terminal is not connected to Port 0. A 3101 attached to Port 
Oofa#1310 can operate via either the RS-232 or RS-422 A interface. Only 3101 model 23 
supports both block mode and the RS-422 A interface. Model 13 supports the RS-422A interface 
but not block mode. 



Consider the following points when setting the 3101 setup switches for direct-connect character 
mode operation: 



Group 1, switch 1 
Group 1 , switch 4 
Group 1 , switch 6 & 7 



Set for character mode operation 

Set for PRTS (permanent request to send) 

Set for CR (carriage return) as the line turnaround character; the 
system uses CR as a default line turnaround character for ACCA 
devices 



Group 1 , switch 8 



Set for mono case. User application programs may use dual case if 
desired. 



Group 2, switch 1 
Group 2, switch 2 & 3 



Set for two stop bits for the Event Driven Executive 

Set for space parity; the system uses space parity for default 
control characters for ACCA devices. 



.y 
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Connecting the 3101 to the Series/1 (continued) 

Attachment options: The jumpers for the #1610 controller, the #2091 controller with #2092 
adapter, and the #2095 controller with #2096 should have Carrier Detect, Data Terminal Ready, 
and Request to Send jumpered on. Also, the high- or LOW-speed option must be jumpered to 
reflect the speed set in the 3101 setup switches. In the switch settings above, the speed is 9600 
bps. The RANGE and BITRATE operands on the terminal definition statement must also be 
compatible with the jumpers and 3101 setup switches. 

In addition, for the #2095/#2096, you must set the eia/tty jumpers properly to reflect your 
physical configuration as either an RS-232C (EIA) or current loop (tty) interface. 

The #1310 adapter does not have speed range, dtr rts, or CD jumpers. However, the BITRATE 
operand on the terminal configuration statement must be compatible with the 3101 setup 
switches. 

Cable connections: See Figure 17 on page IS-256 when your 3101 is attached through the 
#1610 or #2091/2092. 

Operator Input and Internal Code Considerations 

Special considerations that must be given to operator input and internal code representation are 
summarized in Figure 16 . 



■> 



Operator 
function 


Key on 3101 
in character 
mode 


Characters received in the Series/1 with Space Parity set in 
the 3101 setup switches 


Device=ACCA 


Device=TTY 


#1610 or 
# 2091 with 
#2092 


#2095 

with 

#2096 


#7850 


EBASC 


ASCII 


ASCII 


ATTENTION 
ENTER 

BACKSPACE 

(character 

delete) 

LINE 
DELETE 


PF8 

( Key above 
SEND key) 


X'D816B0' 
X'BC 

X'10' 

X'FE' 


X'1 B680D' 
X'OD' 

X'OB' 
X'7F' 


X'1B680D' 
X'OD' 

X'08' 
X'7F' 


(top row, not 
bottom row) 

DEL 

' / 



Figure 16. 3101 Internal Code Representations 

The ECHO=NO and PROTECT=YES Operands on the readtext instruction (for suppression of 
input text) have no effect when the 3101 is attached via the #1310 adapter, the #1610 
controller, the #2091 controller with #2092 adapter, or the #2095 controller with #2096 
adapter. 
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Connecting the 3101 to the Series/1 (continued) 

Special Considerations for 3101 C Use with Half Duplex Modems 

While the majority of the 3101 set-up switches remain unchanged when you use half -duplex 
modems, there are some special requirements for these configurations. The PRTS/CRTS switch 
must be in the CRTS (controlled request to send) or off position. The ESC key will no longer 
function as the attention key; instead, any pf key may be used as the attention key. 

These differences are necessary to allow the 3101 to adhere to the line turnaround protocol 
observed by half-duplex modems. 

3101 Display Terminal in Block Mode 

You can connect the IBM 3101 Display Terminal (in block mode) to the Series/ 1 via four 
attachments: 



the #1310 adapter 

the #1610 controller 

the #2091 controller with #2092 adapter 

the #2095 controller with #2096 adapter. 



Switch Settings 



For attachment of the 3101 through these attachment features, you may set the 3101 setup 
switches as follows: 



Group 1 

1 2 3 4 5 6 7 8 



Group 2 

1 2 3 4 5 6 7 8 



Group 3 

1 2 3 4 5 6 7 8 



on 
off 



X 


X 


X 


X 


X 


X 


X 


X 









X 










X 


X 


X 




X 


X 


X 


X 



X 


















X 


X 


X 


X 


X 


X 


X 



G 


rou 


p4 












1 


2 


3 


4 


5 


6 


7 


8 


X 






X 


X 






X 




X 


X 






X 


X 





These switch settings and "Attachment Options" on page IS-255 correspond to the 
configurations numbered 23, 25, and 26 in Figure 20 on page IS-265. 

The switch settings for the #1310 are the same except that switch 3 of group 1 must be in the 
"off" (rs-422) position if the 3101 terminal is not connected to Port 0. A 3101 model 13 or 23 
attached to Port of a #1310 can operate via either the RS-232 or RS-422A interface. Only 3101 
model 23 supports both block mode and the RS-422A interface. 
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Connecting the 3101 to the Series/1 (continued) 



Consider the following points when you are setting the 3101 setup switches for block mode 
operation: 



Group 1 , switch 1 
Group 1 , switch 4 
Group 1, switch 6 & 7 

Group 1, switch 8 

Group 2, switch 1 
Group 2, switch 2 & 3 

Group 2, switch 4 
Group 2, switch 6 



Set for block mode operation. 

Set for PRTS (permanent request to send) for full duplex modem. 

Set for CR (carriage return) as the line turnaround character; the 
system uses CR as a default line turnaround character for ACCA 
devices. 

Set for mono case. Most IBM system utility programs require the 
mono case switch setting. User application programs may use dual 
case if you want. 

Set for two stop bits for the Event Driven Executive. 

Set for space parity; the system uses space parity for default 
control characters for ACCA devices. 

Set for Send Line Option so that pressing the SEND key activates 
the Send Line function. With this switch setting, the system 
defines the send key as the enter key for the 3101 in block mode. 

Set for Null Suppress Off so that input fields are always of a 
known length. 



Attachment Options 



The jumpers for the #1610 controller, the #2091 controller with #2092 adapter, and the #2095 
controller with #2096 adapter should have Carrier Detect, Data Terminal Ready, and Request to 
Send jumpered on unless the configuration uses a modem. Also, you must jumper the HIGH- or 
LOW-speed option to reflect the speed set in the 3101 setup switches. In the switch settings 
above, the speed is 9600 bps. The range and bitrate operands on the terminal definition 
statement must also be compatible with the jumpers and 3101 setup switches. 

In addition, for the #2095/2096, you should jumper EIA/TTY for either an EIA interface or a 
current loop (tty) interface. 

The #1310 does not have speed range, DTR, RTS, or CD jumpers. However, the bitrate operand 
of the TERMINAL definition statement must be compatible with the 3101 setup switches. 



/ 
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Connecting the 3101 to the Series/1 (continued) 
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Cable Connections 



Figure 17 shows the 3101 (character or block mode) attachment with the #1610 controller or 
the #2091 controller and the #2092 adapter. Figure 18 on page IS-257 shows the 3101 
(character or block mode) attachment with the #1310, #2095 controller with the #2096 adapter 
(eia interface), and the #2095 with RPQ D02350. 



El A interface 



1610 

or 

2091/2 


Attachment cable 




__ 


3101 cable 


3101 
Terminal 


character 
or block 


Feature code 2056 




mode 



1610 

or 

2091/2 



Attachment cable 



Feature code 2057 
or 2944 (Japan) 
or 2724 (U.K.) 



modem 




modem 



3101 cable 



3101 
Terminal 



character 
or block 
mode 



(see Figure 20 on page IS-265 and Figure 19 on page IS-261) 






Figure 17. 3101 Terminal with #1610 or #2091/#2092 
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Connecting the 3101 to the Series/1 (continued) 



El A RS-232C interface 



1310, 
2095/6 
or RPQ 



Attachment cable 



Feature code 2056 



3101 cable 



3101 
Terminal 



Character 
or block 
mode 



1310 

or 

2095/6 



Attachment cable 



Feature code 2057 
or 2944 (Japan) 
or 2724 (U.K.) 



modem 



modem 



3101 cable 



3101 
Terminal 



character 
or block 
mode 



EIA RS-422 interface 



1310 


Attachment cable 


3101 
Terminal 


Character 
or block 
mode 


Feature code 5770 
Attachment cable 










3101 
Terminal 
Models 
13,23 only 




2095/ 

RPQ 

D02350 




Feature code D02352 









20mA Current loop interface 







3101 

Terminal 
Models 
12,22 only 


2095/6 


Attachment cable 


Feature code 2066* 







Character 
or block 
mode 



* This cable is modified according to the source of the transmit 
current. See Figure 19 on page IS-261 
and Figure 20 on page IS- 265. 



Figure 18. 3101 Terminal with #1310, #2095/#2096 and #2095/RPQ D02350 
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Connecting the 3101 to the Series/1 (continued) 

Operator Input and Internal Code Considerations 

For the 3101 Display Terminal in block mode, the system defines the SEND key as the enter key 
(with the Send Line Option setup switch set so that the SEND key acts as the Send Line key). In 
addition, the system default for the Attention key is the PF8 key. 

When the 3101 is connected via the #2095/#2096 attachment, pressing the PF8 key places the 
value X'1B68' into Series/1 storage (with space parity set, and with CR set as the line 
turnaround character in the setup switches). 

When the 3101 is connected via the #1610 or #2091/#2092 attachment, pressing the PF8 key 
places the value X'D816' into Series/ 1 storage (with space parity set, and with CR set as the line 
turnaround character in the setup switches) . 



Configuring Your 3101 



To aid you in configuring your 3101, two figures are presented. Figure 19 on page IS-261 
shows 22 configurations for the 3101 in character mode; Figure 20 on page IS-265 shows 17 
configurations for the 3101 in block mode. 

The individual configurations are numbered sequentially starting with the first configuration in ^ 

Figure 19 and concluding with the configurations in Figure 20. The configuration numbers L 

appear in the left margin on the even numbered page and in the right margin on the odd 
numbered page of the charts. These numbers can be used when referring to a particular 
configuration. 

Select the appropriate figure based upon the transmission mode (character or block) of your 
3101. Locate the appropriate entry in the figure based upon the type of interface and the 
Series/ 1 attachment feature. Now you can read across the figure to find the: 

Series/ 1 attachment feature used for a specific interface 

Attachment options of the attachment feature 

Feature code and part number of the Series/ 1 cable 

Part number of the 3101 cable 

3101 models supported by a specific configuration 

3101 switch setting for a specific configuration 

TERMINAL definition statements specified at system generation corresponding to a specific 
configuration. 
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Configuring Your 31 01 (continued) 



Determine the type of interface and the attachment feature installed in your system. 
Communicate the attachment options required to your IBM Customer Engineer during Series/ 1 
or attachment feature installation. He will install the appropriate options on the attachment 
feature card. You specify the appropriate terminal definition statement and set the 3101 setup 
switches according to the type of configuration. 

While the configurations shown in Figure 1 9 and Figure 20 are typical, they were chosen for 
illustrative purposes only. There may be other 3101 configurations depending on the 
attachment feature and type of interface appropriate for your particular application. 

Be sure to consider the numbered notes indicated in the column headings of each chart. These 
numbers correspond to the list of notes immediately following the charts. 
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Configuring Your 3101 (continued) 
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Configuring Your 31 01 (continued) 















Attachment options (jum 


pers) 






Attachment cable 






Typical 


Range 




Data 








Isolated 








Type 


Series/1 


device 


(bitrate 


Request 


terminal 


Carrier 


TTY- 


Input 


non- 


Feature 


Part number 




of 
interface 


attachment 
features 


address 


for 7850) 


to send 


ready 


detect 


EIA 


select 


Isolated 


code 


or equivalent 




Notes 1-3 


Notes 2-3 


Note 3 


Note 4 1 




Local 


EIA RS232C 


7850 TTY 


00 


9600 


- 


- 


- 


_ 


EIA-Minus 


Not used 


2064 


1632924 


(1) 










(Jumper= 

1111) 










= DataMark 

(Jumper= 

010) 










7850 TTY 


00 


9600 


- 


- 


- 


_ 


EIA-Minus 


Not used 


2065 


4411751 


(2) 










(Jumper= 
1111) 










= Data Mark 

(Jumper= 

010) 








(3) 


1310IV1FA 


58 


- 


- 


- 


- 


- 


- 




2056 


1632211 




1610 


08 


High 


On 


On 


On 


_ 


_ 


_ 


2056 


1632211 


(4) 






Single line 
control ACCA 




(Jumper= 
Medium) 




















2091/2092 


60 


High 


On 


On 


On 


_ 


_ 


_ 


2056 


1632211 


(5) 






Multi-line 
ACCA 
























2095/2096 


68 


High 


On 


On 


- 


EIA 


- 


- 


2056 


1632211 


(6) 






Feature 

programmable 

multi-line 






















(7) 


EIA422 


1310MFA 


58 


- 


- 


- 


- 


- 


- 


- 


5770 


6844552 




2095 with 


68 


High 


On 


On 


On 


_ 


_ 


_ 


D02352 


6844552 


(8) 






RPQ D02350 
























Current loop 


7850 TTY 


00 


9600 


- 


_ 


- 


_ 


Contact 


Isolated 


2066 


6839455 






(3101 supplied 






(Jumper= 










sense closed 


no jumper 


Un- 


Pins: A07-17 


(9) 




current) 






1111) 










=data mark 

(Jumper= 

000) 


(Jumper= 
0) 


modified 


A03-1 8,805-07 
A01 -25, 15-23 
24-1 




2095/2096 


68 


High 


On 


On 


On 


TTY 


_ 


_ 


2066 


6839455 








Feature 


















Modified 


Pins; 


(10) 






programmable 
multi-line 




















A04-17,A01-B01 
B05-18,A03-B03 
B04-25,A05-07 
15-23, 1-24 




Current loop 


7850 TTY 


00 


9600 


- 


- 


_ 




Contact 


Non- 


2066 


6839455 






(attachment 






(Jumper= 










sense 


ilosated 


Modified 


Pins: 


(11) 




supplied 
current) 






1111) 










closed 

= data mark 

(Jumper= 

000) 


(Jumper= 
1) 




A02-15,A03-24 
801-25,805-17 




2095/2096 


68 


High 


On 


On 


On 


TTY 


_ 


_ 


2066 


6839455 








Feature 


















Modified 


Pins: 


(12) 






programmable 
multi-line 




















B06-25,A07-A04 
B05-24,B07-B04 
A06-17,A01-B01 
A05-15,A03-B03 




Current loop 


7850 TTY 


00 


9600 


- 


- 


- 


_ 


Contact 


Isolated 


2066 


6839455 






(3101 and 






(Jumper= 










sense 


no jumper 


Modified 


Pins: 


(13) 




attachment 
both supply 
current) 






1111) 










closed 
=data mark 
(Jumper 
=000) 


(Jumper 
=0) 




A01-25,A02-15 
A03- 18,805- 17 
1-24 




2095/2096 


68 


High 


On 


On 


On 


TTY 


_ 


_ 


2066 


6839455 








Feature 


















Modified 


Pins: 


(14) 






programmable 
multi-line 




















A06-17,A04-A07 
A05-15,A01-B01 
B05-18,A03-B03 
B04-25, 1-24 



Figure 19 (Part 1 of 4). Conf juration Matrix for 3101 in Character Mode 
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3101 Configuration Information 



Configuring Your 3101 (continued) 



Direct 
attach 
or 
modem 


3101 Cable 
part number 


3101 

Model 

supported 


3101 Switch settings corresponding to type of con- 
figuration (1 = On, = Off) 


Terminal configuration statements corresponding to the type of 
configuration 


Group 1 1 Group 2 Group 3 | Group 4 




Note 5 


Note 6 


Note 7 


Notes 


Direct 




10,12,13 
20,22,23 


0010 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=TTY,ADDRESS=00,MODE=3101C 


Direct 


5640736 


10,12,13 
20,22,23 


0010 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=TTY,ADDRESS=00,MODE=3101C 


Direct 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,ADAPTER=MFA, C 
BITRATE=9600,LMODE=LOCAL,MODE=3101C 


Direct 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101C, C 
BITRATE=9600,RANGE=HIGH 


Direct 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,MODE=3101C, C 
BITRATE=2400,ADAPTER = FOUR, C 
RANGE = HIGH 


Direct 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101C, C 
CODTYPE=ASCI l,BITRATE=9600,ATTN =1 868, C 
LF = OA,CR=0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE = HIGH 


Direct 


- 


13,23 


0101 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,ADAPTER=MFA. C 
BITRATE=9600,LMODE-RS422,MODE=3101C 


Direct 




13,23 


0101 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,ADAPTER=EIGHT, C 
CODTYPE=ASCII,BITRATE=9600, C 
LMODE = LOCAL,MODE=3101C 


Direct 




12,22 


0000 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=TTY,ADDRESS=00,MODE=3101C 


Direct 




12,22 


0101 0010 


OOOO 0000 


1000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE = 3101C, C 
CODTYPE=ASCII,BITRATE=9600,ATTN=1B68, C 
LF = 0A,CR = 0D,PF1=1B61,ADAPTER=FOUR, C 
RANGE=HIGH 


Direct 




12,22 


0000 0010 


0000 0000 


1 01 1 0000 


1001 1001 


TERMINAL DEVICE=TTY,ADDRESS=00,MODE = 3101C 


Direct 




12,22 


0101 0010 


0000 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101C, C 
CODTYPE=ASCII,BITRATE=9600,ATTN = 1B68, C 
LF=0A,CR = 0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE = HIGH 


Direct 




12,22 


0000 0010 


0000 0000 


1011 0000 


1001 1001 


TERMINAL DEVICE=TTY,ADDRESS=00,MODE = 3101C 


Direct 




12,22 


0101 0010 


0000 0000 


1000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68.MODE = 3101C, C 
CODTYPE = ASCII,BITRATE=9600,ATTN=1B68, C 
LF = 0A,CR=0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE=HIGH 



(1) 

(2) 
(3) 
(4) 
(5) 

(6) 

(7) 
(8) 

(9) 
(10) 

(11) 
(12) 
(13) 
(14) 



•K.^' 
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Configuring Your 3101 (continued) 



^ 











Attachment options (jumpers) 


Attachment cable 






Typical 


Range 




Data 








Isolated 








Type 

of 

interface 


Series/1 

attachment 

features 


device 


(bitrate 


Request 


terminal 


Carrier 


TTY- 


Input 


non- 


Feature 


Part Number 




address 


for 7850) 


to send 


ready 


detect 


EIA 


select 


isolated 


ccxJe 


or equivalent 




Notes 1-3 


Notes 2-3 


Note 3 


Note 4 1 




Remote 


EIA RS232C 
(Full duplex 


1610 
Single line 


08 


High 
(Jumper= 


On 


On 


On 


- 


- 


- 


2067 or 
2944 


1632208 
1632919 


(15) 




modem non- 
switched) 


control ACCA 




medium) 














(Japan) 
2724 

(U.K.) 


1727744 




2091/2092 


60 


High 


On 


On 


On 


- 


- 


- 


2057 or 


1632208 








Multi-line 


















2944 


1632919 


(16) 






ACCA 


















(Japan) 

2724 

(U.K.) 


1727744 




2095/2096 


68 


High 


On 


On 


On 


EIA 


- 


- 


2057 or 


1632208 








Feature 


















2944 


1632919 


(17) 






programmable 
multi-line 


















(Japan) 

2724 

(U.K.) 


1727744 




Half-duplex 


1310MFA 


58 


- 


- 


- 


- 


- 


- 


- 


2057 or 


1632208 






only 




















2944 


1632919 


(18) 
























(Japan) 

2724 

(U.K.) 


1727744 




EIA RS232C 


1610 


08 


High 


Off 


Off 


Off 


- 


- 


- 


2057 or 


1632208 






(Full duplex 


Single line 




(Jumper= 














2944 


1632919 


(19) 




modem 
switched) 


control 
ACCA 




medium) 














(Japan) 

2724 

(U.K.) 


1727744 




2091/2092 


60 


High 


Off 


Off 


Off 


_ 


- 


- 


2057 or 


1632208 








Multi-line 


















2944 


1632919 


(20) 






ACCA 


















(Japan) 

2724 

(U.K.) 


1727744 




2095/2096 


68 


High 


Off 


Off 


Off 


EIA 


_ 


_ 


2057 or 


1632208 








Feature 


















2944 


1632919 


(21) 






programmable 
multi-line 


















(Japan) 

2724 

(U.K.) 


1727744 




Half-duplex 


1310MFA 


58 


- 


- 


_ 


- 


_ 


- 


- 


2057 or 


1632208 






only 




















2944 


1632919 


(22) 
























(Japan) 

2724 

(U.K.) 


1727744 



Figure 19 (Part 3 of 4). Configuration Matrix for 3101 in Character Mode 
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Configuring Your 31 01 (continued) 



Direct 
attach 
or 
modem 


3101 Cable 
part number 


3101 

Model 

supported 


3101 Switch settings corresponding to type of con- 
figuration (1 = On, = Off) 


Terminal configuration statements corresponding to the type of 
configuration 


Group 1 


Group 2 


Group 3 


Group 4 




Note 5 


Note 6 


Note 7 


Notes 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101C, C 
BITRATE=1200,RANGE=HIGH 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,MODE=3101C, C 
BITRATE=1200,ADAPTER=FOUR, C 
RANGE=HIGH 


Modem 


5640736 


10,12,13, 
20,22,23, 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101C C 
CODTYPE=ASCI l,BITR ATE= 1 200,ATTN= 1 B68, C 
LF=0A,CR=0D,PF1 = 1B61,ADAPTER = FOUR, 
RANGE=H!GH 


Modem 


5640736 


1 0, 1 2, 1 3 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58, C 
ADAPTER=MFA,MODE=3101C 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101C, C 
BIRATE=1200,LMODE=SWITCHED, C 
RANGE=HIGH 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,MODE=3101C, C 
BITRATE=1200,LMODE=SWITCHED, C 
ADAPTER = FOUR,RANGE=HIGH 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1 01 1 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101C, C 
CODTYPE=ASCII,BITRATE=1200,ATTN=1B68, C 
LF=0A,CR=0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE=HIGH,LMODE=SWITCHED 


Modem 


5640736 


10,12,13 
20,22,23 


0111 0010 


0000 0000 


1011 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,MODE=3101C, C 
LMODE=SWITCHED,ADAPTER=MFA 



<15) 



(16) 



H7) 



(18) 



(19) 



(20) 



(21) 



(22) 



Figure 19 (Part 4 of 4). Configuration Matrix for 3101 in Character Mode 
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Configuring Your 3101 (continued) 









Saries/1 

attachment 

features 


Attachment options (jumpers) 


Attachment cable 




Type 

of 

interface 


Typical 

device 

address 


Range 
(bitrate 
for 7850) 


Request 
to send 


Data 

terminal 

ready 


Data 

carrier 

detect 


TTY- 
EIA 


Input 
select 


Isolated 

non- 

isloated 


Feature 
code 


Part Number 
or equivalent 




Notes 1-3 


Notes 2-3 


Note 3 


Note 4 1 


(23) 


Local 


EIA RS232C 


1610 

Single line 
control ACCA 


08 


High 

(Jumper= 

medium) 


On 


On 


On 








2056 


1632211 


(24) 


1310MFA 


58 


- 


- 


- 


- 


- 


- 


- 


2056 


1632211 


(25) 


2091/2092 

Multi-line 
ACCA 


60 


High 


On 


On 


On 


" 


' 


' 


2056 


1632211 


(26) 


2095/2096 

Feature 

programmable 

multi-line 


68 


High 


On 


On 


On 


EIA 






2056 


1632211 


(27) 


El A RS422 


1310MFA 


58 
















5770 


6844552 


(28) 




2095 with 
RPQ D02350 


68 


High 


On 


On 


On 


EIA 






D02352 


6844552 


(29) 


Current loop 
(3101 
supplied 
current) 


2095/2096 

Feature 

programmable 

multi-line 


68 


High 


On 


On 


On 


TTY 






2066 

Modified 


6839455 
Pins: 

A04-17,A01-B01 
B05-18,A03-B03 
A05-7, 15-23 
B04-25, 1-24 


(30) 


Current loop 
(attachment 
supplied 
current) 


2095/2096 
Feature 
programmable 
multi-line 


68 


High 


On 


On 


On 


TTY 






2066 

Modified 


6839455 

Pins: 

B06-25,A07-A04 

B05-24,B07-B04 

A06-17,A01-B01 

A05-15,A03-B03 


(31) 


Current loop 
(3101 and 
attachment 
both supply 
current) 


2095/2096 
Feature 
programmable 
multi-line 


68 


High 


On 


On 


On 


TTY 






2066 

Modified 


6839455 

Pins: 

A06-17,A04-A07 

A05-15,A01-B01 

B05-18,A03-B03 

B04-25, 1-24 



Figure 20 (Part 1 of 4). Configuration Matrix for 3101 in Block Mode 
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3101 Configuration Information 



Configuring Your 3101 (continued) 



Direct 
attach 
or 
modem 


3101 Cable 
part number 


3101 

Model 

supported 


3101 Switch settings corresponding to type of con- 
figuration (1 = On, = Off ) 


Terminal configuration statements corresponding to the type of 
configuration 


Group 1 1 Group 2 1 Group 3 1 Group 4 




Note 5 


Note 6 


Note 7 


Note 8 


Direct 


5640736 


20,22,23 


1111 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101B, C 
BITRATE=9600,RANGE=HIGH 


Direct 


5640736 


20,22,23 


1111 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,MODE=3101 B, C 
BITRATE=9600,ADAPTER=MFA,LMODE=LOCAL 


Direct 


5640736 


20,22,23 


1111 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,MODE=3101B, C 
BITRATE=2400,ADAPTER = FOUR, C 
RANGE=HIGH 


Direct 


5640736 


20,22,23 


1111 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101B, C 
CODTYPE=ASCII,BITRATE=9600,ATTN=1B68, C 
LF = 0A,CR = 0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE = HIGH 


Direct 




13,23 


1101 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,MODE=3101 B, C 
BITRATE=9600,ADAPTER=MFA, C 
LMODE=RS422 


Direct 




13,23 


1101 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE= ACCA,ADDRESS=68,MODE=31 01 B, C 
BITRATE=9600,ADAPTER=EIGHT, C 
LMODE=LOCAL,CODTYPE=ASCII 


Direct 




22 


1101 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101 B, C 
CODTYPE=ASCII,BITRATE=9600,ATTN=1B68, C 
LF=0A,CR=0D,PF1 = 1B61,ADAPTER = FOUR, C 
RANGE=HIGH 


Direct 




22 


1101 0010 


0001 0000 


1 000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=31 01 B, C 
CODTYPE=ASCII,BITRATE = 9600,ATTN=1B68, C 
LF=0A,CR = 0D,PF1 = 1B61,ADAPTER=FOUR, C 
RANGE=HIGH 


Direct 




22 


1101 0010 


0001 0000 


1000 0000 


1001 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101 B, C 
CODTYPE=ASCII,BITRATE=9600,ATTN=1B68, C 
LF=0A,CR=0D,PF1 = 1B61,ADAPTER = FOUR, C 
RANGE = HIGH 



(23) 



(24) 



(25) 



(26) 



(27) 



(28) 



(29) 



(30) 



(31) 






'J 



..J' 
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Configuring Your 3101 (continued) 














Attachment options (jumpers) 


Attachment cable 1 






Typical 


Range 




Data 


Data 






Isolated 








Type 

of 

interface 


Series/1 

attachment 

features 


device 


(bitrate 


Request 


terminal 


carrier 


TTY- 


Input 


non- 


Feature 


Part Number 




address 


for 7850) 


to send 


ready 


detect 


EIA 


select 


isolated 


code 


or equivalent 




Notes 1-3 


Notes 2-3 


Note 3 


Note 4 1 




Remote 


EIA RS232C 
(Full duplex 


1610 
Single line 


08 


High 
(Jumper= 


On 


On 


On 


- 


- 


- 


2057 or 
2944 


1632208 
1632919 


(32) 




modem non- 
switched) 


control 




medium) 














(Japan) 

2724 

(U.K.) 


1727744 




Half-duplex 


1310MFA 


58 


- 


- 


- 


- 


- 


- 


- 


2057 or 


1632208 


(33) 




only 




















2944 

(Japan) 

2724 

(U.K.) 


1632919 
1727744 






2091/2092 


60 


High 


On 


On 


On 


- 


- 


- 


2057 or 


1632208 








Multi-line 


















2944 


1632919 


(34) 






ACCA 


















(Japan) 

2724 

(U.K.) 


1727744 




2095/2096 


68 


High 


On 


On 


On 


EIA 


- 


_ 


2057 or 


1632208 








Feature 


















2944 


1632919 


(35) 






programmable 
multi-line 


















(Japan) 

2724 

(U.K.) 


1727744 






EIA RS232C 


1610 


08 


High 


Off 


Off 


Off 


- 


- 


- 


2057 or 


1632208 






(Full duplex 


Single line 




(Jumper= 














2944 


1632919 


(36) 




modem 
switched) 


control 




medium) 














(Japan) 

2724 

(U.K.) 


1727744 




Half-duplex 


1310MFA 


58 


- 


- 


- 


- 


- 


- 


- 


2057 or 


1632208 


(37) 




only 




















2944 
(Japan) 
2724 
(U.K.) 


1632919 
1727744 






2091/2092 


60 


High 


Off 


Off 


Off 


_ 


_ 


_ 


2057 or 


1632208 








Multi-line 


















2944 


1632919 


(38) 






ACCA 


















(Japan) 

2724 

(U.K.) 


1727744 




2095/2096 


68 


High 


Off 


Off 


Off 


EIA 


_ 


- 


2057 or 


1632208 








Feature 


















2944 


1632919 


(39) 






programmable 
multi-line 


















(Japan) 

2724 

(U.K.) 


1727744 
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3101 Configuration Information 



Configuring Your 31 01 (continued) 



Direct 
attach 
or 
modem 


3101 Cable 
part number 


3101 

Model 

supported 


3101 Switch settings corresponding to type of con- 
figuration (1 <° On, ' Off ) 


Terminal configuration statements corresponding to the type of 
configuration 


Group 1 


Group 2 1 Group 3 | Group 4 




Notes 


Note 6 


Note 7 


Notes 


Modem 


5640736 


20,22,23 


1111 0010 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101B, C 
BITRATE=1200,RANGE=HIGH 


Modem 


5640736 


20,22,23 


1111 0010 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,MODE=3101B, C 
ADAPTER=MFA 


Modem 


5640736 


20,22,23 


1111 0010 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,M,ODE=3101B, C 
BITRATE=1200,ADAPTER=FOUR, C 
RANGE=HIGH 


Modem 


5640736 


20,22,23 


1111 001 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101B, C 
CODTYPE=ASCII,BITRATE=1200,ATTN=1B68, C 
LF=0A,CR=0D,PF1=1B61,ADAPTER=FOUR, C 
RANGE=HIGH 


Modem 


5640736 


20,22,23 


1111 001 


0001 0000 


1 000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=08,MODE=3101B, C 
BITRATE=1200,LMODE=SWITCHED, C 
RANGE=HIGH 


Modem 


5640736 


20,22,23 


1111 0010 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=58,MODE=3101B, C 
LMODE=SWITCHED,ADAPTER=MFA 


Modem 


5640736 


20,22,23 


1111 001 


0001 0000 


1 000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=60,MODE=3101B, C 
BITRATE=1200,LMODE=SWITCHED, C 
ADAPTER=FOUR,RANGE=HIGH 


Modem 


5640736 


20,22,23 


1 1 1 1 001 


0001 0000 


1000 0000 


0101 1001 


TERMINAL DEVICE=ACCA,ADDRESS=68,MODE=3101B, C 
CODTYPE=ASCII,BITRATE=1200, C 
LMODE=SWITCHED,ATTN-1B68,LF=0A, C 
CR=0D,PF1-1B61,ADAPTER=FOUR, C 
RANGE=HIGH 



(32) 



(33) 



(34) 



(35) 



(36) 



(37) 



(38) 



(39) 
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Configuration Matrix Notes 






1. The device addresses shown in Figure 19 on page IS-261 and Figure 20 on page IS-265 are 
typical. For additional information on device addresses, see the IBM Series/ 1 Configurator, 
GA34-0042. 

Note: The attachment feature device address jumpered on the attachment card must agree 
with the ADDRESS= parameter of the terminal definition statement specified during system 
generation. For a description of the terminal definition statement, see Appendix 
A, "System Definition Statements" on page IS-145. 

2. Speed range adapter jumpers differ between attachment features. The following figure 
shows the speed range options that must be jumpered for a specific attachment feature. In 
the figure, N/A means no medium-speed jumper on the #2092 and #2096; no high-speed 
jumper on the #1610; no speed jumpers on the #1310. 



Feature 


Speed range 
(bits/second) 


Low 

speed 

jumper 


Medium 

speed 

jumper 


High 

speed 

jumper 


#7850 Teletypewriter Adapter 


Bitrate of 
110-9600 


- 


- 


- 


#1 61 Asynchronous 
Connmunications Single-Line 
Controller 


110-1200 
300-9600 


Yes 


Yes 


N/A 
N/A 


#2092 Asynchronous 
Communications Four- Line Adapter 


110-1200 
300-2400 


Yes 


N/A 
N/A 


Yes 


#2096 Feature Programmable 
Four- Line Adapter 


110-1200 
300-9600 


Yes 


N/A 
N/A 


Yes 


#1310 Multifunction Attachment 


1200-9600 


N/A 


N/A 


N/A 



Figure 21. Speed range jumper options 

3. The following information refers to the attachment options: 

a. The #7850 TTY attachment feature card does not require speed range selection. However, 
a specific rate selection (bitrate) between 110 and 9600 bits per second (bps) must be 
selected by the use of jumpers on this card. 

b. In all cases where speed range is selectable, the adapter range jumpered must correspond 
to the RANGE= parameter specified in the terminal definition statement. Note, 
however, that the #1310 does not tiave physical speed (bitrate) jumpers. Refer to the 
Machine Logic Diagrams for specific adapter requirements. 
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Configuration Matrix Notes (continued) 

Total system throughput is dependent on the system configuration as follows: 

a. The #1610 Asynchronous Communications Single-Line Controller feature can control 
one line per feature with speeds ranging from 1 10 to 9600 bps. 

b. The #2091 Asynchronous Communications 8-Line Controller feature controls one or 
two 2092 Asynchronous Communications 4-Line Adapter feature (up to four lines per 
feature). Speeds from 1 10 to 2400 bps are supported by the Event Driven Executive 
with a maximum of 2400 bps on all eight lines. 

c. The #2095 Feature-Programmable 8-Line Communications Controller feature supports 
up to two #2096 Feature-Programmable 4-Line Communication Adapter features (up to 
four lines per feature). Speeds from 1 10 to 9600 bps are supported by the Event Driven 
Executive. However, the maximum aggregate throughput you can have is 64000 bps at 
12 bits per character. 

For additional information on speed settings for the above mentioned attachment features, 
see the IBM Series/ 1 Customer Site Preparation Manual^ GA34-0050. 

4. For additional information regarding adapter jumper requirements, see the Machine Logic 
Diagrams or the IBM Series/ 1 Communication Features Theory Diagrams, SY34-0059. 

5. The cable part numbers referenced in Figures 25 and 26 are engineering-change sensitive 

and are subject to revision. Refer to the IBM Series/ 1 Customer Site Preparation Manual, 4""\ 

GA34-0050, for additional cabUng information. L J 

6. Cable bill of material (B/M) 5640736 can be ordered with the 3101 Models 10 (AASiio) 
and 20 (AAS210). For Models 12, 13, 22, and 23, you must order this cable separately. 

7. For additional information regarding attachments and configuration requirements of the 
3101, see the Event Driven Executive Language Programming Guide. 
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The 3101 Group 4 switch settings will vary with different communication line speeds (baud 
rates). The following table lists the Group 4 switch settings for the baud rates supported by 
the 3101. 



Baud rate 


Group 4 


100 


0000 0000 


150 


0001 0001 


200 


0010 0010 


300 


001 1 001 1 


600 


0100 0100 


1200 


0101 0101 


1800 


01100110 


2400 


0111 0111 


4800 


1000 1000 


9600 


1001 1001 






Figure 22. 3101 Supported Baud Rates and Group 4 Switch Settings 

For additional information regarding the 3101 setup switches and interface support provided 
for the 3101, see the IBM 3101 Display Terminal Description, GA18-2033. 

9. For a description of the terminal definition statement, see the Appendix A, "System 
Definition Statements" on page IS- 145. 

a. For illustrative purposes, the range= parameter in the 3101 configuration matrices is 
coded as high to emphasize that the range= parameter must equal the speed range 
option jumper on the attachment feature. When specifying your terminal definition 
statement, you need not code range=high as it is the default. 

b. For device=acca, you can modify the timer values at sysgen time by using the TIMERS 
parameter of the terminal statement and a list of 4 hexadecimal numbers set to the 
value desired. 

c. If you have specified lmode=switched on the terminal configuration statement for 
your 3101 Display Terminal, or specified (or defaulted) lmode=pttopt for a leased 
line connection with modems, you may need to modify the pretransmit and posttransmit 
timers in the DCB that is contained in the CCB for this terminal. 

For lmode= switched, the generated value of the timer 2 transmit word is X'012C'; for 
LMODE=PTTOPT, the generated value of the timer 2 transmit word is X'0002'. You can 
obtain the address of the CCB from the link-edit map of your generated system. You can 
locate the timer 2 transmit word by subtracting X'OOSE' from the CCB address. 
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Depending on the modem and line speed (bit rate) selected, you may have to patch the 
timer 2 transmit word to a higher value. If you do not know the proper value for your 
modem and line speed, try a high value and then successively lower values for the timer 2 
transmit word. 



Following is an example of patching the timer 2 transmit word of the DCB in the CCB of an 
ACCA terminal. In this example, the entry point address of the CCB of the terminal named 
ACCA08 is X'18E6' as shown in the following sample link edit map. 



ENTRY 


$SYSLOG 


0F06 


ENTRY 


$SYSLOGA 


10E0 


ENTRY 


$SYSPRTR 


12C4 


ENTRY 


MPRINTER 


14DC 


ENTRY 


TTYOO 


16D4 


ENTRY 


ACCA08 


18E6 


ENTRY 


ACCA 18 


1BB8 


ENTRY 


MLTA60 


1DB8 


ENTRY 


MLTA6 1 


1FCA 



The timer 2 transmit word is located at address X'18E6' minus X'OOSE' or X*1888' in the 
generated system. 

The following is a sample of the assembled object code containing the timer 2 transmit word 
to be altered. 



K.J 



1872 


2004 


0000 


0000 


0000 


0000 


187C 


0000 


0002 


1460 


0002 


0002 


1886 


OOOA 


012C 


0000 


0000 


0000 


1890 


0000 


001D 


1FFE 


BOBO 


BOBO 
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Configuration Matrix Notes (continued) 



Use $DISKUT2 to patch the timer 2 transmit word from X*012C' to X'0200' as follows: 






\ 



> $L $D1SKUT2 

$DISKUT2 it6P,00:00:00, LP= 8F00 

USING VOLUME GD3101 

COMMAND (?): PA 

PGM OR DS NAME: $EDXNUC 

$EDXNUC IS A PROGRAM OF HEX SIZE 00003B7E 

ADDRESS: 1888 

HOW MANY WORDS? 1 

(D)EC, (E)BCDIC OR {H)EX? H 



NOW IS: 
1888 



A 



012C 

ENTER DATA: 0200 

NEW DATA: 
1888 0200 

OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 

COMMAND (?): EN 
$DISKUT2 ENDED 



After completing the previous procedure, the timer 2 transmit word is as follows: 



y 



1872 


2004 


0000 


0000 


0000 


0000 


187C 


0000 


0002 


1460 


0002 


0002 


1886 


OOOA 


0200 


0000 


0000 


0000 


1890 


0000 


001D 


1FFE 


BOBO 


BOBO 



For additional information about the DCB and the timer 2 transmit word, see 
"Asynchronous Communications" in the IBM Series/ 1 Communications Features 
Description, GA34-0028. 



Appendix C. 3101 Configuration Information IS-273 



Notes 






IS-274 SC34-0646 



^^/ 



Appendix D. Supervisor Module Names 

(CSECTS) 






This appendix contains the names of all the object modules you can include in your supervisor. 
The first column lists the names of entry points into specific object modules. The second 
column lists the names of the object module to which the entry point is associated. Other object 
modules within your supervisor can refer to each entry point. 

After you generate your supervisor, check the $xpslink link map to see if you have any 
unresolved EXTRNs. An unresolved extrn is caused by a supervisor object module referring to 
an entry point within another supervisor object module that is not included in your supervisor. 
Locate the entry point that corresponds to the unresolved extrn. The associated module name 
indicates whether or not you must modify the EDXDEFS or LINKCNTL data sets. A module name 
of $EDXDEF signifies that you must correct an existing definition statement or that you failed to 
code a required definition statement in the edxdefs data set. All other module names signify 
which supervisor object module must be included in the LINKCNTL data set. Modify the 
appropriate data set and run the $JOBUTlL procedure again to regenerate your supervisor. 

Note: Following each occurrence of $edxdef is the name of the definition statement that is 
either in error or missing. 
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Entry 


Object 


Entry 


Object 


Point 


Module 


Point 


IVIodule 


$A 


RLOADER 


$MFAOPEN 


INITMODS 


$ACTIVE 


RLOADER 


$MSGBUF 


FULLMSG 


$ADPINIT 


INITMODS 


$MSGBUF 


MINMSG 


$ADPOPEN 


INITMODS 


$NUMPART 


$EDXDEF (SYSTEM) 


$AUTOINT 


INITMODS 


$PARTSZE 


$EDXDEF (SYSTEM) 


$BITS 


EDXALU 


$PGMCINT 


INITMODS 


$BONOFF 


EDXALU 


$PHYSTG 


$EDXDEF (SYSTEM) 


$BSCADDR 


EDXSYS 


$PRINT2 


$EDXTIO 


$BSCADS 


XPSPART 


$QIOADS 


XPSPART 


$BSCAINT 


INITMODS 


$SBIOADS 


XPSPART 


$BSCFDDB 


$EDXDEF (BSCLINE) 


$SBIOINT 


INITMODS 


$BUFF 


$EDXTIO 


$SBPITAB 


EDXSYS 


$ CANCEL 


RLOADER 


$SEGINIT 


EDXINIT1 


$CFATTN 


$EDXTIO 


$SFLIST 


EDXSYS 


$CFINIT1 


INITMODS 


$SLOGPRM 


SYSLOG 


$CFINIT2 


INITMODS 


$SLOGTSK 


SYSLOG 


$CFPARM 


EDXSYS 


$SRMADS 


XPSPART 


$CN 


RLOADER 


$SRTBL 


NOSRMGR 


$COMPADR 


EDXALU 


$ START 


EDXSYS 


$COMPCNT 


EDXALU 


$ STORAGE 


$EDXDEF (SYSTEM) 


$COMPE 


EDXALU 


$STORINT 


INITMODS 


$COMPNE 


EDXALU 


$SVCBCTL 


EDXSYS 


$CP 


EDXSVCX 


$SVCIBUF 


$EDXDEF (SYSTEM) 


$CVTADS 


XPSPART 


$SVCLSB 


EDXSVCX 


$DDBC 


$EDXDEF 


$SVCSIA 


EDXSVCX 


$DSKADS 


XPSPART 


$SVCSTOP 


EDXSVCX 


$DISKINT 


INITMODS 


$SYSCOM 


$EDXDEF (SYSTEM) 


$DMDDB 


EDXSYS 


$SYSLOG 


$EDXDEF (TERMINAL) 


$DMVOL 


EDXSYS 


$SYSLOGA 


$EDXDEF (TERMINAL) 


$DPEND 


$EDXTIO 


$SYSLOGB 


$EDXDEF (TERMINAL) 


$DSKINT1 


INITMODS 


$SYSL0G1 


$EDXDEF (TERMINAL) 


$DSKINT2 


INITMODS 


$SYSL0G2 


$EDXDEF (TERMINAL) 


$EDXINIT 


EDXINIT1 


$SYSPRTR 


$EDXDEF (TERMINAL) 


$EDXTIO 


NOTIO 


$ TAPE INT 


INITMODS 


$EDXPTCH 


$EDXDEF (SYSTEM) 


$TESTADR 


EDXSYS 


$EXEC 


EDXALU 


$TESTCOM 


$DBUGNUC 


$EXIODDB 


$EDXDEF (EXIO) 


$TIMEINT 


INITMODS 


$EXIOINT 


INITMODS 


$TIMRTBL 


EDXSYS 


$FINDE 


EDXALU 


$TIOADS 


XPSPART 


$FINDNE 


EDXALU 


$TPDDB 


EDXSYS 


$FLTADS 


XPSPART 


$TPDDB1 


TPCOM 


$FRSTACB 


EDXSYS 


$TPDVADR 


$EDXDEF 


$HOSTINT 


INITMODS 


$TPIA 


TPCOM 


$IAMQCB 


EDXSYS 


$TRCLSB 


EDXSTART 


$INITMOD 


$EDXDEF (SYSTEM) 


$TRCSIA 


$DBUGNUC 


$INITPRT 


$EDXDEF (SYSTEM) 


$TRMINIT 


INITMODS 


$IOUS 


$EDXDEF (SYSTEM) 


$TRMOPEN 


INITMODS 


$IPLHOOK 


EDXSYS 


$USRATT1 


$EDXTIO 


$IPLVOL 


EDXSYS 


$USRATT2 


$EDXTIO 


$ LOAD INT 


INITMODS 


$USRATT3 


$EDXTIO 


$L0ADIN2 


INITMODS 


$XPSBCTL 


EDXSYS 


$LOGIA 


SYSLOG 


$XPSHEAD 


EDXSYS 


$LOGPARM 


EDXSYS 


$XPSINIT 


EDXINIT1 


$LOGTSK 


SYSLOG 


$XPSTABL 


EDXSYS 


$ MAP AREA 


$EDXDEF (SYSTEM) 


$XTSK 


X21CMD 


$MEMSIZE 


$EDXDEF (SYSTEM) 


$X21IA 


$X21IA 


$MFAINIT 


INITMODS 


$4013INT 


INITMODS 
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$4978INT 

$4980INT 

$4980OPN 

##ZERO## 

##ZERO## 

#ACLOSE 

#ALLSCB 

# ATTN 10 

#ATTN10A 

#ATTN35 

#ATTN40 

#ATTN50 

#ATTN5 1 

#ATTN55A 

#ATT1024 

#BSCENTR 

#BSCIA 

#BSCIORT 

#BSCSTRT 

#CMDSETU 

# CMOS TUP 

#CNTLEND 

#CTLXFER 

#CURCTL 

#DELRT 

#DELSCB 

#DEQBSC 

#DEQLBNK 

#DEQT 

#DISKCHN 

#DISKRW 

#DISKTBL 

#DQTERMS 

#DQTERMS 

#DQTRMIN 

#DQTRMIN 

#DSKCAC 

#DSKER13 

#DSKIO00 

#DSKI099 

#DSKPOST 

#EBBICVT 

# END ATTN 

#ENQLBNK 

#ENQT 

#FLIHPST 

#FLIH04 

#FLIH36A 

#FLIH40 

#FLIH50 

#FLIH54 

#GETVAL2 

#GETVAL4 

#IAVIRT 

#IFB 

#IFDW 

#IFTEST 

#IFTEST1 

#IFW 

#IOGPIB 



INITMODS 

INITMODS 

INITMODS 

EDXSYS 

XPSSYS 

D4969A 

NOSRMGR 

D49624 

D4963A 

D49624 

D49624 

D4966A 

D4966A 

D4966A 

$D1024 

BSCAM 

BSCAM 

BSCAM 

BSCAM 

EDXALU 

EDXALU 

D4963A 

EDXTIO 

EDXTIO 

DISKIO 

NOSRMGR 

BSCAM 

NOLRDCHK 

EDXTERMQ 

DISKIO 

DISKIO 

DISKTBL 

EDXTERMQ 

NOTIO 

EDXTERMQ 

NOTIO 

D4963A 

DISKIO 

DISKIO 

$DISKIO 

$DISKIO 

EDXTIO 

EDXTIO 

NOLRDCHK 

EDXTERMQ 

$D4969A 

$DISKIO 

D49624 

D4963A 

D49624 

D49624 

EDXTIO 

EDXTIO 

lOSVIRT 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

lOSGPIB 



#IOSPEND 

#IOSPWR 

#IOSTERM 

#IOVIRT 

#104973 

#104974 

#104975 

#104978 

#104979 

#105219 

#105224 

#105225 

#KBTASK 

#MESSAGE 

#MESSAGE 

#MSGBUF 

#NOP 

#NXTCMDA 

#PRSKSP 

#PRTEXT 

#PRTNUM2 

#PRTNUM4 

#PWRAM80 

#QUESTON 

#QUEUEIO 

#QUTRMIN 

#RDGPIB 

#RDTEXT 

#RDTEXTL 

#SAI 

#SAIA 

#SAIS 

#SAIX 

#SAO 

#SAOA 

#SAOX 

#SBCOM 

#SBPI 

#SDI 

#SDIA 

#SDIS 

#SDIX 

#SDO 

#SDOA 

#SDOP 

#SDOS 

#SDOX 

#SLOGTSK 

#STATS78 

#TAPEEND 

#TERMINT 

#TERMINT 

#TERMOUT 

#TERMOUT 

#TPEIO00 

#TPEI099 

#WRGPIB 

#4966B 

#624ATTN 

#624DCB 



lOSPOOL 

I OS POOL 

lOSTERM 

lOSVIRT 

IOS4974 

IOS4974 

IOS4974 

IOS4979 

IOS4979 

IOS4974 

IOS4974 

IOS4974 

EDXTIO 

FULLMSG 

MINMSG 

FULLMSG 

EDXALU 

$EDXTIO 

EDXTIO 

EDXTIO 

EDXTIO 

EDXTIO 

PWRM80 

EDXTIO 

#QUEUEIO 

EDXTERMQ 

lOSGPIB 

EDXTIO 

EDXTIO 

SBAI 

SBAI 

SBAI 

SBAI 

SBAO 

SBAO 

SBAO 

SBCOM 

SBPI 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SBDIDO 

SYSLOG 

IOS4979 

$D4969A 

EDXTIO 

NOTIO 

EDXTIO 

NOTIO 

D4969A 

$D4969A 

lOSGPIB 

D4966A 

D49624 

D49624 
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#624ERP D49624 

#624INIT D49624 

#63ADCB D4963A 

#63ATTN D4963A 

#63ERP D4963A 

#63INIT D4963A 

#66ADCB D4966A 

#66AERP D4966A 

#66ATTN D4966A 

#69ATTN D4969A 

#69ERP D4969A 

#69ERP8 D4969A 

ACCACTL lOSACCA 

ACLOSE D4969A 

ACLOSE $D69AXPS 

ACLOSERT RLOADER 

AHA $SBAI 

ALLSCB NOSRCHK 

ALPOSTED EDXSVCX 

AND1 EDXALU 

AND 1 XX EDXALU 

AND 2 EDXALU 

AND2XX EDXALU 

AND4 EDXALU 

AND4XX EDXALU 

ASMDEBUG EDXINITI 

ATTACH EDXSVCX 

ATTACHX EDXSVCX 

BDCDWORD EDXTIO 

BDCWORD EDXTIO 

BFRCK EDXALU 

BFRCK XPSSYS 

BHXWORD EDXTIO 

BRACKN $ EDXTIO 

BRANCH EDXALU 

BSCENTRY BSCAM 

BSCIA BSCAM 

BSCINIT BSCINIT 

BSCRETER BSCAM 

BSCGRET BSCAM 

CCBFIXA EDXINIT 

CDRVTA $EDXDEF (TERMINAL) 

CDRVTB $EDXDEF (TERMINAL) 

CGOTO EDXALU 

CIRCNT CIRCBUFF 

CIREND CIRCBUFF 

CIRESIZ CIRCBUFF 

CIRESTR CIRCBUFF 

CIRIN CIRCBUFF 

CIRSTR CIRCBUFF 

CKEXIT SBCOM 

CKEXITO $ SBCOM 

CMDSETUP EDXALU 

CMDSETUP XPSSYS 

CMDTABLE EDXSYS 

CMPRSDME RSLCMPR 

CNTLBUSY D4963A 

CNTLEND D4963A 

CNTLEND $D63AXPS 

CONINSIA EDXSTART 



CTLXFER 

CTLXFER 

CTLXFER 

CURCTL 

CURCTL 

CURCTL 

DATEFMT 

DATTN10 

DATTN10 

DATTN10A 

DATTN10A 

DATTN35 

D ATTN 3 5 

DATTN40 

DATTN40 

D ATTN 50 

D ATTN 50 

DATTN50A 

D ATTN 5 1 

D ATTN 51 

DATTN55A 

DATTN55A 

DATT1024 

DATT1024 

DCBDWORD 

DCBRETRN 

DCBWORD 

DCB3DATA 

DEBUG IT 

DECSCAN 

DELRT 

DELRT 

DELSCB 

DELSCBX 

DEQ 

DEQBSC 

DEQHOST 

DEQLBNK 

DEQT 

DEQT 

DEQT 

DETACH 

DFLIH04 

DFLIH04 

DFLIH36A 

DFLIH36A 

DFLIH40 

DFLIH40 

DFLIH50 

DFLIH50 

DFLIH54 

DFLIH54 

DIIA 

DINITDS1 

DISKATTN 

DISKBUFR 

DISKBUFX 

DISKCHN 

DISKERR1 

DISKERR1 



EDXTIO 

NOTIO 

$TIOXPS 

EDXTIO 

NOTIO 

$TIOXPS 

$EDXDEF (TIMER) 

$D624XPS 

D49624 

$D63AXPS 

D4963A 

$D624XPS 

D49624 

$D624XPS 

D49624 

D4966A 

$D66AXPS 

D4966A 

$D66AXPS 

D4966A 

$D66AXPS 

D4966A 

DSKXPS 

$D1024 

EDXTIO 

DISKIO 

EDXTIO 

EDXTIO 

BSCAM 

EDXTIO 

$DSKXPS 

DISKIO 

NOSRCHK 

NOSRCHK 

EDXSVCX 

BSCAM 

TPCOM 

NOLDRCHK 

NOTIO 

EDXTERMQ 

$TIOXPS 

EDXSVCX 

$DISKIO 

DSKXPS 

$D624XPS 

D49624 

D4963A 

$D63AXPS 

D49624 

$D624XPS 

D49624 

$D624XPS 

$SBDIDO 

EDXINITI 

D49624 

SEGINIT 

DISKINIT 

DISKIO 

$DISKIO 

DSKXPS 



\^ 



C 
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DISKERR2 

DISKERR2 

DISKERR3 

DISKERR3 

DISKERR5 

DISKERR5 

DISKERR7 

DISKERR7 

DISKER13 

DISKER13 

DISKER17 

DISKER17 

DISKER18 

DISKER18 

DISKER5A 

DISKER5A 

DISKER5B 

DISKER6B 

DISKER6B 

DISKFLIH 

DISKFLIH 

DISKINT1 

DISKINTX 

DISKIO 

DISKIOOO 

DISKIOOO 

DISKI032 

DISKIO40 

DISKPOST 

DISKPOST 

DISKPREP 

DISKRET 

DISKRET2 

DISKRW 

DISKRW 

DISKRW05 

DKSCAC 

DMDDB 

DMIPL 

DMVOL 

DMXTNT 

DMXTNT3 

DOIA 

DQTERM 

DQTERMB 

DQTERMS 

DQTRMIN 

DSCKSUM 

DSKCAC 

DSKCAC 

DSKCHKA 

DSKCHKD 

DSKCHKAR 

DSKCHKDR 

DSKCHKER 

DSKINITX 

DSKINIT1 

DSKPREP2 

DSKXRET1 

DSKXRET2 



$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

DISKIO 

$DSKXPS 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

$DISKIO 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

DISKINT1 

DSKINIT2 

$DSKXPS 

DISKIO 

$DSKXPS 

D4966A 

D4966A 

$DISKIO 

DSKXPS 

DISKINIT 

DISKIO 

DISKIO 

DISKIO 

$DSKXPS 

DISKIO 

$D63AXPS 

$EDXDEF (DISK) 

$EDXDEF (DISK) 

$EDXDEF (DISK) 

$DISKIO 

$DISKIO 

$SBDIDO 

EDXTERMQ 

EDXTERMQ 

EDXTERMQ 

EDXTERMQ 

RSLCMPR 

D4963A 

$D63AXPS 

NODSKCHK 

NODSKCHK 

DISKIO 

DISKIO 

DISKIO 

DSKINIT2 

DSKINIT1 

DISKINIT 

DISKIO 

DISKIO 



DSKXRET3 

D1024ATN 

D1024FLG 

D1024R 

D1024RET 

D1024V1 

D4962IH1 

D49624AT 

D4963AT 

D4963ATN 

D4963AT1 

D4963IH1 

D4966AT 

D4966ATN 

D4966B 

D4966B 

D6 2 4 ATTN 

D6 2 4 ATTN 

D624ERP 

D624ERP 

D624INIT 

D624INIT 

D63ATTN 

D63ATTN 

D63ERP 

D63ERP 

D63INIT 

D63INIT 

D66AERP 

D66AERP 

D66ATTN 

D66ATTN 

D66INIT 

D69ATTN 

D69ATTN 

D69DHPT 

D69ERP 

D69ERP 

D69ERP8 

D69ERP8 

D69FLIH 

EBBICVT 

EBBICVT 

EBBICVT 

EBB IE 

EBFLDBL 

EBFLPTCH 

EBFLSTD 

EDXDEBUG 

EDXFLAGS 

EDXFLEND 

EDXINITP 

EDXLOOP 

EDXL00P2 

ENABLED 

ENDATTN 

ENDATTN 

ENDATTN 

ENDCODE 

ENDINIT 



DISKIO 

D1024 

$D1024 

D1024 

D1024 

$D1024 

D49624 

$D49624 

$D4963A 

D4963A 

D4963A 

D4963A 

$D4966A 

D4966A 

D4966A 

$D66AXPS 

$D624XPS 

D49624 

$D624XPS 

D49624 

$D624XPS 

D49624 

$D63AXPS 

D4963A 

$D63AXPS 

D4963A 

$D63AXPS 

D4963A 

$D66AXPS 

D4966A 

$D66AXPS 

D4966A 

DISKINIT 

$D69AXPS 

D4969A 

$D4969A 

$D69AXPS 

D4969A 

D4969A 

$D69AXPS 

$D4969A 

EDXTIO 

NOT 10 

$TIOXPS 

EDXTIO 

EBFLCVT 

EBFLCVT 

EBFLCVT 

EDXINIT1 

EDXSYS 

EDXFLOAT 

EDXINIT1 

EDXALU 

EDXALU 

EDXINIT1 

EDXTIO 

NOT 10 

$TIOXPS 

RLOADER 

EDX START 
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ENQ EDXSVCX FLIHPOST $D4969A 

ENQLBNK NOLDRCHK FLIHPOST DSKXPS 

ENQT EDXTIO FLOATERR EDXFLOAT 

ENQT NOT 10 FLOATERR NOFLOAT 

ENQT EDXTERMQ FLRND EBFLCVT 

ENQT $TIOXPS FLTCONV EDXFLOAT 

E0R1 EDXALU FLTCONV NOFLOAT 

E0R1XX EDXALU FLTPATCH EDXFLOAT 

E0R2 EDXALU FMPYOOO EDXFLOAT 

E0R2XX EDXALU FMPYOOO NOFLOAT 

E0R4 EDXALU FMPY001 EDXFLOAT 

E0R4XX EDXALU FMPY001 NOFLOAT 

ERREXIT3 RLOADER FMPY010 EDXFLOAT 

ERRORLOG DISKIO FMPY010 NOFLOAT 

EXCLOSE lOSEXIO FMPY011 EDXFLOAT 

EXFLIH lOSEXIO FMPY011 NOFLOAT 

EXIO lOSEXIO FMPY100 EDXFLOAT 

EXIOCLEN lOSEXIO FMPY100 NOFLOAT 

EXIOINIT EXIOINIT FMPY101 EDXFLOAT 

EXOPEN lOSEXIO FMPY101 NOFLOAT 

EXPNDME RSLCMPR FMPY110 EDXFLOAT 

FADDOOO EDXFLOAT FMPY110 NOFLOAT 

FADDOOO NOFLOAT FMPYI 1 1 EDXFLOAT 

FADD001 EDXFLOAT FMPYI 1 1 NOFLOAT 

FADD001 NOFLOAT FREEMAIN RLOADER 

FADD010 EDXFLOAT FREERETN STORMGR 

FADD010 NOFLOAT FREESTGC STORMGR 

FADD011 EDXFLOAT FSUBOOO EDXFLOAT 

FADD011 NOFLOAT FSUBOOO NOFLOAT 

FADD100 EDXFLOAT FSUB001 EDXFLOAT 

FADD100 NOFLOAT FSUB001 NOFLOAT 

FADD101 EDXFLOAT FSUB010 EDXFLOAT 

FADD101 NOFLOAT FSUBO 1 NOFLOAT 

FADD110 EDXFLOAT FSUBO 11 EDXFLOAT 

FADD110 NOFLOAT FSUBO 11 NOFLOAT 

FADD111 EDXFLOAT FSUBIOO EDXFLOAT 

FADD111 NOFLOAT FSUBIOO NOFLOAT 

FDIVOOO EDXFLOAT FSUB101 EDXFLOAT 

FDIVOOO NOFLOAT FSUB101 NOFLOAT 

FDIV001 EDXFLOAT FSUB110 EDXFLOAT 

FDIV001 NOFLOAT FSUB110 NOFLOAT 

FDIV010 EDXFLOAT FSUBI 1 1 EDXFLOAT 

FDIV010 NOFLOAT FSUBI 1 1 NOFLOAT 

FDIV011 EDXFLOAT FULLMSG FULLMSG 

FDIV011 NOFLOAT GETCNT EDXALU 

FDIV100 EDXFLOAT GETDDB SBCOM 

FDIV100 NOFLOAT GETMAIN RLOADER 

FDIV101 EDXFLOAT GETPAR3 EDXALU 

FDIV101 NOFLOAT GETPAR3 XPSSYS 

FDIV110 EDXFLOAT GETRETF STORMGR 

FDIV110 NOFLOAT GETRETN STORMGR 

FDIV111 EDXFLOAT GETVAL2 EDXTIO 

FDIV1 1 1 NOFLOAT GSTVAL2 NOTIO 

FH4963CT RW4963ID GSTVAL2 $TIOXPS 

FIRSTACB $EDXDEF (ADAPTER) GETVAL4 EDXTIO 

FIRSTBSC $EDXDEF (BSCLINE) GSTVAL4 NOTIO 

FIRSTCCB $EDXDEF (TERMINAL) GSTVAL4 $TIOXPS 

FLDCLEAR EDXTIO GFQCB RLOADER 

FLEBDBL EBFLCVT GOTOTABL RLOADER 

FLEBSTD EBFLCVT GPIB $EDXDEF 
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GTIMDATE 

GTIMDATE 

HCACKO 

HCACK1 

HCDLEETX 

HCDLESTX 

HCENQCC 

HCEOT 

HCFLAGS 

HCID 

HCLENHS 

HCLENPT 

HCNACK 

HCRESNE 

HCRESNI 

HCRESNI 

HCRESPO 

HCRESP1 

HCRETCD 

HCSMID 

HCSTBYTE 

HCTDBUFF 

lAACCA 

lAACCATR 

lACEND 

lACHKCC 

lADELAY 

lAEXIOTR 

lAGPIB 

lAMQCB 

lAPROC 

lASCII 

IAS1S1 

lATTY 

IA2741 

IA4013 

IA4973 

IA4974 

IA4975 

IA4978 

IA4979 

IA4980 

IA5219 

IA5224 

IA5225 

IDCBRES 

IDCBSCSS 

IDCBSIO 

IDCBSIO 

IDCBSIOD 

IDCBRES 

IDCBSCSS 

IDCBTOD 

IDSKI099 

IDSKI099 

IDSKPOST 

IDSKPOST 

ID4963IH 

IFFLOAT 

IFFLOAT 



EDXTIMER 

EDXTIMR2 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

$IOSACCA 

$ACCATRC 

$IOSACCA 

$IOSACCA 

$IOSACCA 

EXIOTRC 

$IOSGPIB 

CDIDQCB 

$IOS2741 

$I04975A 

$I0SS1S1 

ilOSTTY 

$1052741 

$IOS4013 

$IOS4974 

$IOS4974 

$IOS4974 

$IOS4979 

$1054979 

$1054979 

$1054974 

$1054974 

$1054974 

TPCOM 

TPCOM 

TPCOM 

TPC0M1 

TPCOM 1 

TPCOM 1 

TPC0M1 

TPC0M1 

$DISKIO 

DSKXPS 

$DISKIO 

DSKXPS 

RW4963ID 

EDXFLOAT 

NOFLOAT 



IFFLOATL 

IFFLOATL 

INITEXIT 

INITFEAT 

INITTASK 

INIT4013 

INIT4978 

INTIME 

INTIME 

INTIMEX 

INTIMEX 

lOACPOST 

lOACPOST 

lOACPRE 

lOACPRE 

lOERROR 

lOEXPOST 

I0EXP05T 

lOEXPRE 

lOEXPRE 

lOGPIB 

lOLOAD 

I0R1 

I0R1XX 

I0R2 

I0R2XX 

I0R4 

I0R4XX 

lOSPCLOS 

lOSPCMD 

lOSPDQT 

lOSPEND 

I05PNQT 

lOSPTBL 

lOSPWR 

lOSRETN 

lOSTABLE 

lOSTRT 

I0S1S1 

IOS3101D 

I054979M 

lOUNLOAD 

lOWRTCON 

IO1024I 

IO1024RT 

103101 

104974 

104974 

104974 

I04975A 

104979 

104979 

104979 

IPLENDED 

IPLMSG 

IPLMSG 

KBTASK 

KBTA5K 

KBTASK 

LCB 



EDXFLOAT 
NOFLOAT 
EDXINIT1 
EDXINIT1 
EDXSTART 
INIT4013 
INIT4978 
EDXTIMER 
EDXTIMR2 
EDXTIMER 
EDXTIMR2 
NOACCATR 
ACCATRC 
NOACCATR 
ACCATRC 
lOSACCA 
NOEXIOTR 
EXIOTRC 
NOEXIOTR 
EXIOTRC 
$IOSGPIB 
lOLOADER 
EDXALU 
EDXALU 
EDXALU 
EDXALU 
EDXALU 
EDXALU 
^ lOSPOOL 
$IOSPOOL 
lOSPOOL 
$IOSPOOL 
lOSPOOL 
$ lOSPOOL 
lOSPOOL 
lOSACCA 
lOSTABLE 
lOSACCA 
I0SS1S1 
1053101 
1054979 
lOLOADER 
lOSACCA 
IO1024 
DISKINIT 
IO53101 
1054974 
NOTIO 
$TI0XP5 
I054975A 
1054979 
NOTIO 
$TIOXPS 
EDXSTART 
DISKINIT 
EDXINIT1 
EDXTIO 
NOTIO 
$TIOXPS 
SYSLOG 
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LCBA 

LCMDKEY 

LCMDTGT 

LEX 

LOADBUFR 

LOADEXIT 

LOADFHFL 

LOADFLAG 

LOADINIT 

L0ADINIT2 

LOADORG 

LOADPGM 

LOADPGMO 

LOADQCB 

LOADTASK 

LOADTERM 

LPGMXPA 

LPGMXPB 

LPRINTER 

LPO 

MAPEND 

MECBLST 

MESSAGE 

MESSAGE 

MESSAGE 

MFARMU 

MINMSG 

MOVEXP 

MOVE P 4 

M0VFP4 

M0VFP8 

M0VFP8 

MOVI 

MOVIC 

MOV 2 

M0V2C 

M0V4 

M0V4C 

MPRTR1 

MPRTR2 

MPRTR3 

MSGBUF 

MSGBUFR 

MSGMOD 

MSGMOD 

NAKMSG 

NEXTERM 

NOTDEF 

NOTPWRON 

NSRMGR 

NXTCOMD 

OPNCLS 

OVLAREAO 

OVLEND 

OVLSTART 

PACK 

PARTFLAG 

PASS#2 

PCHKIIP 

PCHKLSB 



EDXSYS 

RLOADER 

RLOADER 

EDXSVCX 

LOADBUFR 

RLOADER 

RLOADER 

NOSRMGR 

LOADINIT 

L0ADINIT2 

RLOADER 

RLOADER 

RLOADER 

RLOADER 

RLOADER 

PWRM80 

RLOADER 

RLOADER 

$EDXDEF (TERMINAL) 

RLOADER 

$EDXDEF (SYSTEM) 

$EDXDEF (SYSTEM) 

FULLMSG 

NOT 10 

$TIOXPS 

$EDXDEF (ADAPTER) 

MINMSG 

EDXALU 

EDXFLOAT 

NOFLOAT 

EDXFLOAT 

NOFLOAT 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

$EDXDEF (TERMINAL) 

$EDXDEF (TERMINAL) 

$EDXDEF (TERMINAL) 

FULLMSG 

EDXSTART 

FULLMSG 

MINMSG 

$EDXTIO 

TERMINIT 

$EDXTIO 

$1084979 

NOSRMGR 

EDXTIO 

D4969A 

SEGINIT 

DISKINIT 

SEGINIT 

RSLCMPR 

NOSRMGR 

EDXINIT1 

EDXSTART 

EDXSTART 



PCHKSIA 

PGMCHECK 

PGMCHK 

PIIABIT 

PIIAG17 

PI I ALEX 

PNTREND 

POST 

POSTWTM 

PREPIDCB 

PRINTIME 

PRINTIME 

PRSKSP 

PRSKSP 

PRSKSP 

PRTEXT 

PRTEXT 

PRTEXT 

PRTNUM2 

PRTNUM2 

PRTNUM2 

PRTNUM2S 

PRTNUM4 

PRTNUM4 

PRTNUM4 

PRTNUM4S 

PSTUSER 

PWRAM80 

PWRTEST 

QIO 

QUESTION 

QUESTION 

QUESTION 

QUTERM 

QUTERMIN 

RADDRESS 

RDACCA 

RDCB 1 CNT 

RDCB1 

RDCB2 

RDCB 3 

RDCB4 

RDCB5 

RDCB6 

RDCB7 

RDCB 8 

RDCB 9 

RDGPIB 

RDS 1 S 1 

RDTEXT 

RDTEXT 

RDTEXT 

RDTEXTL 

RDTEXTL 

RDTEXTL 

RDTTY 

RD2741 

RD4013 

RECKSUM 

RETURN 



EDXSTART 

EDXINITI 

XPSSYS 

$SBPI 

$SBPI 

$SBPI 

EDXSVCX 

EDXSVCX 

SWAITM 

DISKINIT 

EDXTIMER 

EDXTIMR2 

EDXTIO 

NOT 10 

$TIOXPS 

EDXTIO 

NOT 10 

$TIOXPS 

EDXTIO 

NOT 10 

$TIOXPS 

EDXTIO 

EDXTIO 

NOT 10 

$TIOXPS 

EDXTIO 

DISKIO 

PWRM80 

PWRM80 

QIO 

EDXTIO 

NOTIO 

$TIOXPS 

EDXTERMQ 

EDXTERMQ 

TPC0M1 

lOSACCA 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

TPC0M1 

$IOSGPIB 

I0SS1S1 

EDXTIO 

NOTIO 

$TIOXPS 

EDXTIO 

NOTIO 

$TIOXPS 

lOSTTY 

IOS2741 

IOS4013 

RSLCMPR 

EDXSYS 
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RLENGTH 

SAI 

SAIA 

SAIS 

SAIX 

SAO 

SAOA 

SAOX 

SATTACH 

SAVERET 

SAVEXIT 

SAV222CR 

SAV224CR 

SAV424CR 

SAV444CR 

SAX222 

SA222 

SA222C 

SA424 

SA424C 

SBERR 

SBIODDB 

SBIOINIT 

SCALL 

SCONTINU 

SCWAIT 

SDEQ 

SDETACH 

SDI 

SDIA 

SDIS 

SDIX 

SDO 

SDOA 

SDOLOOP 

SDOP 

SDOS 

SDOX 

SD222 

SD222C 

SD422CR 

SD422R 

SD424 

SD424C 

SEGINIT 

SEGREGE 

SEGREGE 

SELBOl 

SENQ 

SETBUSY 

SETBUSY 

SETCLOCK 

SETCLOCK 

SETIMER 

SETIMER 

SETREADY 

SFLIST 

SFTKSIA 

SHL1 

SHLIXX 



TPC0M1 

SBAI 

SBAI 

SBAI 

SBAI 

$SBAO 

$SBAO 

$SBAO 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

SBCOM 

$EDXDEF ( 

SBIOINIT 

EDXALU 

EDXALU 

EDXSVCX 

EDXSVCX 

EDXSVCX 

$SBDIDO 

$SBDIDO 

$SBDIDO 

$SBDIDO 

$SBDIDO 

$SBDIDO 

EDXALU 

$SBDIDO 

$SBDIDO 

$SBDIDO 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

SEGINIT 

NOSTRMGR 

STORMGR 

EDXSVCX 

EDXSVCX 

EDXSVCX 

XPSSYS 

EDXTIMER 

EDXTIMR2 

EDXTIMER 

EDXTIMR2 

EDXSVCX 

$EDXTIO 

EDXSTART 

EDXALU 

EDXALU 



SENSORIO) 



SHL2 

SHL2XX 

SHL4 

SHL4XX 

SHR1 

SHR1XX 

SHR2 

SHR2XX 

SHR4 

SHR4XX 

SM222 

SM222C 

SM424 

SM424C 

SPOST 

SRADDR 

SRESETEV 

SRETURN 

SSX222 

SS222 

SS222C 

SS424 

SS424C 

START 

STARTFLG 

STARTPGM 

START 1 

STATUS 

STESTIN 

STESTIN1 

STESTOUT 

STKINIT 

STMTBLE 

STOP 

ST0PC5 

STOPDA 

STOPDB 

STOPDC 

STOPDD 

STOPDE 

STOPDF 

STOPEB 

STOPEC 

STOPED 

STOPEE 

STOPEF 

STOPFB 

STOPFC 

STOPFD 

STOPFE 

STOPFO 

ST0PF1 

ST0PF2 

ST0PF3 

ST0PF4 

ST0PF5 

ST0PF6 

ST0PF7 

ST0PF8 

ST0PF9 



EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXSVCX 

EDXINIT1 

EDXSVCX 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXINIT 

EDXINIT 

EDXSTART 

EDXINIT1 

lOSACCA 

$DBUGNUC 

$DBUGNUC 

$DBUGNUC 

SEGINIT 

STORMGR 

RLOADER 

BSCINIT 

INIT4980 

INITMFA 

INITMFA 

INITMFA 

INITMFA 

INITMFA 

INIT4980 

INITADAP 

INITADAP 

INITADAP 

INITADAP 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

SEGINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 

XPSINIT 
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STOPTASK 

STOREMAP 

STORINIT 

STP 

STPTASK1 

STPTASK2 

SUPEXIT 

SUPEXIT 

SUPEXTRL 

SUPLEX 

SUPLVLXO 

SUPTBL 

SVC 

SVC 

SVCA 

SVCAKR 

SVCBF 

SVCBFEND 

SVCBFIN 

SVCBFOUT 

SVCBOTH 

SVCFLAGS 

SVCFLAGS 

SVCHNDLR 

SVC I 

SVCIAKR 

SVCIAR 

SVCIBFOF 

SVCIIAR 

SVCILSB 

SVCILSR 

SVCIRO 

SVCIR1 

SVCIR2 

SVCIR3 

SVC IRA 

SVCIR5 

SVCIR6 

SVCIR7 

SVCLSB 

SVCLSR 

SVCLT 

SVCL1 

SVCL2 

SVCL3 

SVGPARMS 

SVCRTRN 

SVCRO 

SVCR1 

SVCR2 

SVCR3 

SVCR4 

SVCR5 

SVCR6 

SVCR7 

SVCTRC 

SVCO 

SVC1 

SVC2 

SWAIT 



RLOADER 

$EDXDEF 

STORINIT 

TPCOM 

EDXSVCX 

EDXSVCX 

EDXSVCX 

XPSSYS 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

XPSSYS 

EDXSVCX 

EDXSYS 

$EDXDEF (SYSTEM) 

$EDXDEF (SYSTEM) 

EDXSYS 

EDXSYS 

EDXSVCX 

EDXSYS 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSYS 

EDXSYS 

EDXSVCX 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSYS 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 



SX224CR 

SX224R 

SX444 

SX444C 

SYSCOM 

S1S1 

S1S1DIAG 

TAPEEND 

TAPEEND 

TAPEEND 

TAPEINIT 

TAPEIO 

TAPEIOOO 

TAPEIOOO 

TAPE I 09 9 

TAPE I 09 9 

TAPE060 

TASKWD 

TERMDEFS 

TERMERRX 

TERMINID 

TERMINT 

TERMOPEN 

TERMOUT 

TIMERDDB 

TIMERO 

TIMERO 

TIMEROIA 

TIMEROIA 

TIMER1 

TIMER1IA 

TIMRINIT 

TIMRINIT 

TIMRLSB 

TLENGTH 

TLSB 

TPIABUSY 

TPIABUSY 

TPIABUSY 

TPINIT 

TPSTATS 

TRASCII 

TRASCII 

TRCRSP 

TRCRSP 

TREE AS C 

TREE AS C 

TREECD 

TREBCD 

TSOPEN 

UNCHAIN 

UNCHAIN 

UNCHAKR1 

UNCHSAV6 

UNPACK 

USER 

USERFLAG 

USERMOD 

USERPOST 

VARYDSCE 



EDXALU 

EDXALU 

EDXALU 

EDXALU 

EDXSYS 

$EDXDEF (TERMINAL) 

S1S1INIT 

$D4969A 

DSKXPS 

$D4969A 

TAPEINIT 

D4969A 

D4969A 

$D69AXPS 

DSKXPS 

$D4969A 

DISKIO 

EDXSTART 

$EDXDEF (TERMINAL) 

TERMINIT 

TERMINIT 

EDXTIO 

TERMOPEN 

EDXTIO 

$EDXDEF (TIMER) 

$EDXDEF (TIMER) 

EDXTIMR2 

EDXTIMER 

EDXTIMR2 

$EDXDEF (TIMER) 

EDXTIMER 

TIMRINIT 

CLOKINIT 

EDXTIMR2 

TPCOM 1 

EDXSVCX 

$D4969A 

DSKXPS 

$D4969A 

TPINIT 

TPCOM 

ASCIITAB 

TRASCII 

CRSPTAB 

TRASCII 

EBASCII 

TREBASC 

EECDTAB 

TREBCD 

D4969A 

XPSSYS 

EDXSVCX 

EDXSYS 

EDXSYS 

RSLCMPR 

EDXALU 

INITMODS 

INITMODS 

DISKIO 

DISKIO 
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VARYDSCB 

VARYEXIT 

VARYEXIT 

VARYOFF 

VARYOFF 

VARYON 

VARYON 

VARYQCB 

VARYQCB 

VARYWORD 

VARYWORD 

VCTBL 

VRYBUF 

VRY4966 

VRY4969 

WAIT 

WAI TIMER 

WAITIMER 

WAITM 

WAITMR 

WDCB1 

WDCB2 

WDCB3 

WDCB3CHN 

WDCB4 

WDCBCHN 

WDCB5 

WHATIME 

WHAT I ME 

WHATMSG 



$DISKIO 

DISKIO 

$DISKIO 

DISKIO 

$DISKIO 

DISKIO 

$DISKIO 

DISKIO 

$DISKIO 

DISKIO 

$DISKIO 

lOSTABLE 

TAPEBUFR 

$D4966A 

$D4969A 

EDXSVCX 

EDXTIMER 

EDXTIMR2 

S WAITM 

S WAITM 

TPCOMl 

TPC0M1 

TPCOMl 

TPCOMl 

TPCOMl 

TPCOMl 

TPCOMl 

EDXTIMER 

EDXTIMR2 

$EDXTIO 



WRACCA 

WRGPIB 

WRPRSTAT 

WRS 1 S 1 

WRTTY 

WR2741 

WR4013 

WR4975A 

WTMERCD 

XLATE 

XPSBAL1 

XPSBAL6 

XPSBAL7 

XPSBR 

XPSDEBUG 

XPSHEADR 

XPSINITX 

XPSRET2 

XPSRET3 

XPSSTK 

XPSSTKE 

XPSSVCI 

XPSSVCI 

XPSSVCIX 

XP STABLE 

XPSTBL 

XPSTSIZE 

X21CLR 

X2 1 CON 



lOSACCA 

$IOSGPIB 

IOS4975A 

I0SS1S1 

lOSTTY 

IOS2741 

IOS4013 

IOS4975A 

EDXSVCX 

RSLCMPR 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

EDXSVCX 

SEGINIT 

XPSINIT 

EDXSVCX 

EDXSVCX 

$EDXDEF (SYSTEM) 

$EDXDEF (SYSTEM) 

XPSSYS 

EDXSVCX 

EDXSVCX 

XP STABLE 

XPSTABLE 

XPSTABLE 

BSCX21 

BSCX21 
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Appendix E. Work Sheets 



This appendix contains the work sheets you need to select the required support for your 
operating system. 

• Use WORK SHEET 1 to estimate the overall size of your supervisor. Use work sheet 4 to 
estimate the size of portions of your supervisor. 

• Use WORK SHEET 2 to define the characteristics and partition structure of processor storage 
and the I/O devices attached to your Series/ 1 . 

• Use WORK SHEET 3 to define the software features you require to support the defined I/O 
devices and the EDX-related products you include in your system. 

• Use WORK SHEET 4 to estimate the size of those portions of the supervisor that in partitions 
other than partition one and the amount of storage required by programs to execute within a 
partition. 

The work sheets are provided for you to use with Chapter 4, "Select Your Required Support" 
on page IS-39. Tear out or copy the work sheets you require, and complete them as you select 
the system features you need for your system. We recommend making a copy of each work 
sheet so that you will have the originals if you need to generate a system in the future. 
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Work Sheet 1 



o 



Support 



Resident 



Initialization 



To estimate the overall size of your supervisor, use work sheet 1 . Work sheet 1 contains three 
columns: Support, Resident, and Initialization. 



This column Usts the I/O devices you can attach to the Series/ 1. Read down the Ust and choose 
the specific devices you are attaching to your Series/ 1; cross out the devices that are not part of 
your system, along with the corresponding storage amounts. The Resident column and the 
Initialization column, if applicable, show the amount of storage required by the supervisor to 
support a specific device. 



This column contains the amount of storage the supervisor requires to support each device. 
These numbers are the resident program sizes and are expressed in the number of decimal bytes. 



This column contains the amount of storage the initiahzation routine requires at IPL time for a 
specific device. These numbers are expressed in the number of decimal bytes. 



Supervisor Size 



To estimate the size of your supervisor, total the Resident column and round this total to the 
next multiple of 256. The resulting figure is the estimated size of your supervisor program that 
will reside in storage during system execution. Allow from three to five per cent more storage to 
provide for error correction. This estimate will be reasonably close to your actual configuration; 
to get the actual size, perform a system generation of your supervisor. The actual size is the 
address (in hexadecimal) of edxinit in the $xpslink output. 
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Work Sheet 1 (continued) 






Support 


Resident 


Initial izat ion 


Basic supervisor 






with address translator 


8058 


614 


(sum of MAXPROG values) * 8 + 32 


( ) 




+ #IABUF (defaults to 20) * 8 


( ) 




+ #XPSSTK (defaults to 20) * 6 


( ) 




+ #MECBLST (defaults to 20) * 2 


( ) 




Disk, diskette, or tape 






Disk(ette) basic 


1912 


3420 


+200 per unit 


( ) 




+ ^7 per performance volume 


( ) 




+128 per I/O task defined 


( ) 




4962/4964 


1466 




4963/4967/DDSK-3O 


692 




4963 with fixed-head 




526 


+178 per unit 


( ) 




4965/4966 


1652 




1024 Byte/Sector Support 


428 




1024 Byte/Sector IPL Support 


2596 




4968/4969 


4920 


1706 


+130 per unit 


( ) 




+128 per I/O task defined 


( ) 




Terminals 






Basic 


5664 


1182 


MFA (feature 1310) 




1036 


+50 per adapter 


( ) 




ALPA (feature 1250) 




2478 


+50 per adapter 


( ) 




SMIO (feature 5640) 




2478 


+50 per adapter 


( ) 




4979/4978/4980 


2640 


1812 


+488 per 4978/4979/4980 


( ) 




4973/4974/4975/5219/5224/5225 


744 




+550 per 4973 or 4974 


( ) 




+562 per 4975 


( ) 




+562 per 5219 


( ) 




+562 per 5224 


( ) 




+562 per 5225 


( ) 




4013 type devices 


506 


182 


+458 per device 


( ) 





Figure 23 (Part 1 of 3). Supervisor Storage Requirements. 
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Work Sheet 1 (continued) 



Support 


Res ident 


Initial izat ion 


Virtual terminals 


650 




+^70 per terminal 


( ) 




Series/1 to Series/1 


1264 


274 


+62^ per device 


( ) 




GPIB 


734 




+574 per adapter 


( ) 




Basic for 






any TTY, 2741/PROC, non-3101B, ACCA 


648 




+5U if ASCI i/EBCDIC 






convers ion 


( ) 




+5l4 if mirror image 






ASCI 1 /EBCDIC conversion 


( ) 




Teletypewriter 


740 




+470 per teletypewriter 


( ) 




2741/PROC 


1524 




+594 per 2741/PROC 


( ) 




+532 if correspondence code 


( ) 




+522 if EBCD code 


( ) 




ACCA ASCII Terminals no MFA 


1848 




+530 per terminal 


( ) 




3101 (block mode) 


2250 




+724 per device 


( ) 




Spool 






Basic (in supervisor) 


2104 




+(460*max active jobs)+32 


( ) 




Basic (in user partition) 


5120 




+Y+Z 


( ) 




where: 






Y=264*max active jobs 






Z=(34"max jobs) 






+(2*no. of sectors/100 






+(20"no. of writers) 






Each output writer 






( in user part i tion) 


3840 




Timers 






4955 


1308 


354 


4952/4954/4956 


1264 


188 
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Work Sheet 1 (continued) 






Support 


Res i dent 


Initial i zat ion 




Binary synchronous access method 
Any BSC device 
1 n addi t ion: 


3884 


430 




+ 22 per multiline feature 

+136 per 1 ine 
X.21 Facility 
Host Communication Facility 


( ) 
( ) 
1760 
2238 


364 




Sensor-based input/output 
Bas ic 


144 


180 


• 


Analog input 

+^♦8 for first Al group 
+16 for each 


702 
( ) 






additional group 


( ) 






Analog output 

+16 per AO 
Digital input and output 

+38 per Dl group 

+16 per DO group in 4982 

+38 per DO group in IDIO 
Process interrupt 

+156 per PI group 


90 
( ) 
1014 
( ) 
( ) 
( ) 
168 
( ) 






EXIO control 
Basic 
+(32+x(l6+n)) per device 
where: 


830 

( ) 


66 




x=maximum number of DCBs 








n=number of residual status 








bytes transferred 








Error logging 
i ncluded 
not included 


362 
26 






Program/machine check loq 


..32 






Relocating loader 


4044 


1986 




Floating point 
i ncluded 


772 






not included 


6 






Support of GETEDIT/PUTEDIT 


1628 






Queue processing 


326 






$DEBUG 


522 







Supervisor patch area 



256 



Figure 23 (Part 3 of 3). Supervisor Storage Requirements. 
Notes: 



1. The above numbers include 128 bytes per terminal for the optional keyboard task 
(attn=yes). 

2. Teletypewriter, ACCA, 2741, and 4013 terminals require basic ASCII support. 
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Work Sheet 2 



Work sheet 2 helps you define your processor storage and I/O devices. The work sheet contains 
the system definition statements used in this step. Each definition statement is presented in the 
form: 



label 


STATEMENT 


OPERAND 






blank 


SYSTEM 


MAXPROG= ( 


lit 


t 1 III 


PARTS= ( 
DATEFMT= 
IABUF= 
XPSSTAK= , 
COMMON= ( 
INITPRT= 
INITMOD= ( 
MECBLST= 


1 t ; _ 

_ t 1 / 

/ 1 





In addition, you can use specific definition statements to define different devices. Depending 
upon the device you are defining, the system requires different operands. A sample statement is 
shown for each device type. 






The right-hand column contains a key that indicates if an operand is required or optional and 
specifies the default. A detailed description of the statements, along with the syntax and 
operand definitions, is provided in Appendix A, "System Definition Statements" on page 
IS-145. 
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Work Sheet 2— Installation and System Generation 



SYSTEM DEFINITION STATEMENTS 
Storage definition 

blank SYSTEM MAXPROG= 

PARTS= 



DATEFMT= 
IABUF= 
XPSSTK= 
COMMON^ 

INITPRT= 

IN1TM0D= 

MECBLST= 

DEVICE=4969, 

ADDRESS^ 

DENSITY= 

LABEL= 

ID= 

TASK= 

END- 

DEVICE=4968, 

ADDRESS= 

DENSITY- 

LABEL= 

ID= 

TASK= 

END= 



Tape definition 

blank TAPE 



blank TAPE 



Disk(ette) definition 

blank DISK 



DEVICE-4962, 

ADDRESS- 

VOLNAME- 

TASK= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 

Optional-defaults to 10 

Optional-defaults to 32K 

Optional-defaults to MMDDYY 
Optional-defaults to 20 
Optional-defaults to 20 
Optional-defaults to EDXSYS 

Optional-defaults to 1 

Optional 

Optional 

Required 
Required 

Optional-defaults to 1600 
Optional-defaults to SL 
Required 

Optional-defaults to NO 
Optional-defaults to NO 

Required 
Required 

Optional-defaults to 1600 
Optional-defaults to SL 
Required 

Optional-defaults to NO 
Optional-defaults to NO 

Required 

Required 

Optional 

Optional-defaults to NO 

Optional-defaults to NO 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 

Disk(ette) definition (continued) 

blank DISK DEVICE=4963, 

ADDRESS= 
VOLNAME= 
TASK= 
END= 



blank DISK 



blank DISK 



blank DISK 



blank DISK 



blank DISK 



DEVICE=4967, 

ADDRESS= 

VOLNAME= 

TASK= 

END= 



DEVICE=DDSK-30 

ADDRESS= 

VOLNAME= 

TASK= 

END= 



DEVICE=4964 
ADDRESS= 
TASK- 
END- 

DEVICE=4965 
ADDRESS- 
TASK- 
END- 

DEVICE-4966 
ADDRESS- 
TASK- 
END- 



REQUIRED/OPTIONAL/DEFAULTS 



Required 

Required 

Optional 

Optional-defaults to NO 

Optional-defaults to NO 

Required 

Required 

Optional 

Optional-defaults to NO 

Optional-defaults to NO 



Required 

Required 

Optional 

Optional-defaults to NO 

Optional-defaults to NO 

(Specify YES if last TAPE 

or DISK statement) 

Required 
Required 

Optional-defaults to NO 
Optional -defaults to NO 

Required 
Required 

Optional-defaults to NO 
Optional-defaults to NO 

Required 
Required 

Optional-defaults to NO 
Optional-defaults to NO 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 



Timer definition 

blank TIMER 
Adapter definition 

label ADAPTER 



label 



ADAPTER 



label ADAPTER 



Terminal definition 

Virtual Terminals 

label TERMINAL 



ADDRESS- 



ADDRESS= 
TYPE=MFA, 
DEVICES- 
END= 

ADDRESS- 
TYPE=ALPA, 
DEVICES- 
END- 

ADDRESS- 

TYPE-SMIO, 

DEVICES- 

END- 



ADDRESS-VIRT 
ADDRESS- 

LINSIZE- 

SYNC- 

END- 



REQUIRED/OPTIONAL/DEFAULTS 

Required 

Required 
Required 
Required 
Optional-defaults to NO 

Required 
Required 
Required 

Optional-defaults to NO 

Required 
Required 
Required 

Optional-defaults to NO 
(Specify YES if last 
ADAPTER statement) 



Required 

Required-enter label of 
other virtual terminal 
Optional-defaults to 132 
Optional-defaults to NO 
Optional-defaults to NO 
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Woric Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 

Terminal definition (continued) 

Virtual Terminals (continued) .-; 

label TERMINAL ADDRESS=VrRT 
ADDRESS= 

LINSIZE 

SYNC= 

END= 



Series/1 =Series/1 

label TERMINAL 



DEVICE=S1S1 

ADDRESS= 

LINSIZE= 

CHKSUM= 

END= 



GPIB (General Purpose Interface Bus) 
label TERMINAL DEVICE=GPIB 
ADDRESS= 
CODTYPE= 
LINSIZE= 
ATTN= 
SCREEN= 

PART= 

SPOOL= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 



Required 

Required-enter label of 
other virtual terminal 
Optional-defaults to 132 
Optional-defaults to NO 
Optional-defaults to NO 
(Specify YES is last 
TERMINAL statement) 

Required 
Required 

Optional-defaults to 80 
Optional-defaults to 16 
Optional-defaults to NO 
(Specify YES is last 
TERMINAL statement) 

Required 
Required 

Optional-defaults to ASCII 
Optional-defaults to 80 
Optional-defaults to YES 
Optional-defaults to NO 
(YES/ROLL or NO) 
Optional-defaults to partition 1 
Optional-defaults to NO 
Optional-defaults to NO 
(Specify YES if last 
TERMINAL statement) 
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Work Sheet 2— Installation and System Generation (continued) 

SYSTEM DEFINITION STATEMENTS REQUIRED/OPTIONAL/DEFAULTS 



Terminal definition (continued) 

Processor to Processor Communications 
label TERMINAL DEVICE=PROC 
ADDRESS= 
CODTYPE= 

LINSIZE= 
CRDELAY= 

BITRATE= 

RANGE= 

CR= 

LF= 

END= 



Required 

Required (in hexadecimal) 
Optional-defaults to EBCDIC 
(DRSP/EBCD)EBCDIC) 
Optional-defaults to 130 
Optional-defaults to (PROMPT,300000) 
(PROMPT,n/SP5100,n/DELAY,n) 
Optional-defaults to 9600 
Optional-HIGH/LOW-defaults to HIGH 
Optional-defaults to 5B 
Optional-defaults to 5B 
Optional-defaults to NO 
(Specify YES if last 
TERMINAL statement) 
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Woric Siieet 2— installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 
Terminal definition (continued) 



2741 Terminal 

label TERMINAL 



DEVICE=2741. 

ADDRESS= 

PAGSIZE= 

LINSIZE= 

CODTYPE= 

TOPM= 

BOTM= 

LBFTM= 

RIGHTM= 

OVFLINE= 

LINEDEL= 

CHARDEL= 

CRDELAY= 

ECHO- 

BITRATE= 

ADAPTER- 

CR= 

LF= 

SCREEN- 

PART- 
SPOOL- 
END- 



REQUIRED/OPTIONAL/DEFAULTS 



Required 
Required 

Optional-defaults to 66 
Optional-defaults to 130 
Optional-defaults to EBCD 
(EBCD/CRSP) 
Optional-defaults to 
Optional-defaults to 65 
Optional-defaults to 
Optional-defaults to 129 
Optional-defaults to NO 
Optional-(2 digit hex char) -defaults to AO 
Optional-(2 digit hex char) -defaults to 5D 
Optional-defaults to 
Optional-defaults to YES 
Optional-defaults to 134 bps 
Optional-(specify SINGLE) 
Optional-defaults to 5B 
Optional-defaults to 5B 
Optional-defaults to NO 
(YES or ROLL/NO) 
Optional-defaults to partition 1 
Optional-defaults to NO 
Optional-defaults to NO 
(Specify YES if last 
TERMINAL statement 
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Woric Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 
Terminal definition (continued) 



4013 Graphics Terminal 
label TERMINAL 



DEVICE=4013, 

PAGSIZE= 

LINSIZE= 

CODTYPE- 

TOPM= 

BOTM= 

LEFTM= 

RIGHTM= 

OVFLINE- 

LINEDEL= 

CHARDEL- 

CRDELAY= 

ECHO= 

CR= 

LF= 

SCREEN= 




REQUIRED/OPTIONAL/DEFAULTS 



Required 



Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 



onal-defaults to 35 

onal-defaults to 72 

onal-specify ASCII 

onal-defaults to 

onal-defaults to 34 

onal-defaults to 

onal-defaults to 71 

onal-defaults to NO 

onal-(2 digit hex char)-defaults to 7F 

onal-(2 digit hex char)-defaults to 08 

onal-defaults to 

onal-defaults to YES 

onal-defaults to OD 

onal-defaults to OA 

onal-defaults to NO 



(YES/ROLL or NO) 
Required (one of the three) 

Optional-defaults to partition 1 

Optional-defaults to NO 

(Specify YES if last TERMINAL statement) 
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Work Sheet 2— installation and System Generation (continued) 

SYSTEM DEFINITION STATEMENTS REQUIRED/OPTIONAL/DEFAULTS 

Terminal definition (continued) 



4973/4974 Printers 
label TERMINAL 



4975 Printer 

label TERMINAL 



DEVICE- 
ADDRESS 
PAGSIZE= 
LINSIZE= 
TOPM= 
BOTM= 
LEFTM= 
RIGHTM= 
OVFLINE= 
SPOOL= 
END- 



DEVICE=4975 
ADDRESS- 
PAGSIZE- 
LINSIZE- 
CHARSET- 
TOPM= 
BOTM- 
LEFTM= 
RIGHTM- 
OVFLINE- 
BITRATE- 
LMODE= 
ADAPTER-MFA 
SPOOL- 
END- 



Required (specify 4973 or 4974) 
Required 



Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 
Opt 



onal-defaults to 66 
onal-defaults to 132 
onal-defaults to 3 
onal-defaults to 63 
onal-defaults to 
onal-defaults to 131 
onal-defaults to NO 
onal-defaults to NO 
onal-defaults to NO 



(Specify YES if last TERMINAL statement) 

Required 

Required 

Optional-defaults to 66 

Optional-defaults to 132 

Optional-defaults to USCA 

Optional-defaults to 3 

Optional-defaults to 63 

Optional-defaults to 

Optional-defaults to 131 

Optional-defaults to NO 

Optional-defaults to 1200 bps 

Optional-defaults to LOCAL 

Required 

Optional-defaults to YES 

Optional-defaults to NO 

(Specify YES if last TERMINAL statement) 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 
Terminal definition (continued) 



4978/4979 Terminals 
label TERMINAL 



DEVICE= 

ADDRESS= 

LINSIZE= 

TOPM- 

BOTM= 

NHIST- 

LEFTM= 

R1GHTM= 

OVFLINE- 

HDCOPY= 

ATTN= 

PF1 = 

SCREEN= 

PART= 

SPOOL= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 



Required (specify 4978 or 4979) 

Required 

Optional-defaults to 80 

Optional-defaults to 

Optional-defaults to 23 

Optional-defaults to 12 

Optional-defaults to 

Optional-defaults to 79 

Optional-defaults to NO 

Optional-defaults to $SYSPRTR 

Optional-defaults to YES 

Optional-(2 digit hex char)-defaults to 02 

Optional-defaults to ROLL 

(YES/NO/STATIC) 

Optional-defaults to partition 1 

Optional-defaults to NO 

Optional-defaults to NO 

(Specify YES if last TERMINAL statement) 
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Woric Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 
Terminal definition (continued) 



4980 Terminals 

label TERMINAL 



DEVICE=4980, 

ADDRESS= 

LINSIZE= 

TOPM= 

BOTM= 

NHIST= 

BITRATE= 

LEFTM= 

RIGHTM= 

OVFLINE= 

HDCOPY= 

ATTN= 

PF1 = 

SCREEN= 

I 

. rAriT= 

SPOOL= 

ADAPTER^SMIO, 

PORT= 

SECADDR= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 



Required 
Required 

Optional-defaults to 80 
Optional-defaults to 
Optional-defaults to 23 
Optional-defaults to 12 
Required-defaults to 100K bps 
Optional-defaults to 
Optional-defaults to 79 
Optional-defaults to NO 
Optional-defaults to $SYSPRTR 
Optional-defaults to YES 
Optional-(2 digit hex char)-defaults to 02 
Optional-defaults to ROLL 
(YES/ROLL, STATIC or NO) 
Optional-defaults to partition 1 
Optional-defaults to NO 
Required 

Required-specify or 1 
Required-specify 00 through FE 
Optional-defaults to NO 
(Specify YES if last 
TERMINAL statement) 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 

Terminal definition (continued) 

5219/5224/5225 

label TERMINAL 



DEVICE= 

ADDRESS^ 

PAGSIZE 

LINSIZE= 

CHARSET= 

TOPM= 

BOTM= 

LEFTM= 

RIGHTM= 

OVFLINE= 

LMODE= 

ADAPTER=ALPA, 

SPOOL= 

PORT= 

SECADDR= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 



Required (specify 5219, 5224, or 5225) 
Required 

Optional-defaults to 66 
Optional-defaults to 132 
Optional-defaults to USCA 
Optional-defaults to 3 
Optional-defaults to 63 
Optional-defaults to 
Optional-defaults to 131 
Optional-defaults to NO 
Optional-defaults to LOCAL 
Required 

Optional-defaults to YES 
Required-specify or 1 
Required-specify 00 through 06 
Optional-defaults to NO 
(Specify YES if last 
'TERMINAL statement) 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 
Terminal definition (continued) 



ACCA-type Terminals 
label TERMINAL 



DEVICE= 

ADDRESS= 

MODE= 

PAGSIZE= 

CODTYPE= 

LINSIZE= 

TOPM= 

NHIST= 

BOTM= 

LEFTM= 

RIGHTM= 

OVFLINE= 

LINEDEL^ 

CHARDEL- 

CRDELAY= 

BITRATE= 

RANGE= 
LMODE- 
ADAPTER 

COD= 
CR= 

LF= 

ATTN= 

PF1 = 

SCREEN= 

PART= 

TIIVIERS= 

SPOOL= 

END= 



REQUIRED/OPTIONAL/DEFAULTS 



Required (specify ACCA or 3101) 

Required 

Required-(3101C/3101B) 

Optional 

Optional-(ASCII/EBASC) 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional-defaults to NO 

Optional-(2 digit hex char) 

Optional-(2 digit hex char) 

Optional 

Optional-defaults to 300 bps; 

for MFA, defaults to 1200 bps 

Optional-defaults to HIGH 

Optional-(RS422/LOCAL/SWITGHED/PTTOPT) 

Optional-(SI NG LE/TWO/FOU R 

SIX/EIGHT/MFA) 

Optional 

Optional-defaults to BO for EBASC; 

defaults to OD for ASCII 

Optional-defaults to 50 for EBASC; 

defaults to OA for ASCII 

Optional-defaults to YES 

(NO/YES/LOCAL/NOSYS/NOGLOB) 

Optional-(2 digit hex char)-defaults to 1 B61 

for ASCII and D886 for EBASC 

Optional-(YES/NO/STATIC) 

Optional-defaults to partition 1 

Optional 

Optional -defaults to NO 

Optional -defaults to NO 

(Specify YES if last TERMINAL statement) 
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Work Sheet 2— Installation and System Generation (continued) 

SYSTEM DEFINITION STATEMENTS REQUIRED/OPTIONAL/DEFAULTS 



Terminal definition (continued) 



TTY Terminals 

label TERMINAL 



DEVICE=TTY, 

ADDRESS= 

MODE= 

PAGSIZE 

CODTYPE=ASCII, 

LINSIZE= 

TOPM= 

BOTM= 

LEFTM= 

RIGHTM= 

OVFLINE= 

LINEDEL= 

CHARDEL= 

CRDELAY= 

ECHO= 

CR= 

LF= 

ATTN= 

PF1 = 

SCREEN= 

PART= 

SPOOL= 

END= 



Binary Synchronous line definition 

label BSCLINE ADDRESS^ 

TYPE= 

RETRIES= 
MC= 

ADAPTER= 
POLL= 

END= 



Required 

Required 

Optional-specify 3101C 

Optional 

Required 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional 

Optional-(2 digit hex char) 

Optional-(2 digit hex char) 

Optional 

Optional-defaults to YES 

Optional-defaults to OD 

Optional-defaults to OA 

Optional-defaults to YES 

(NO/YES/ALL/LOCAL/NOSYS/NOGLOB) 

Optional-(2 digit hex char) 

Optional-(YES or ROLL/NO) 

Optional-defaults to partition 1 

Optional-defaults to NO 

Optional-defaults to NO 

(Specify YES if last TERMINAL statement) 

Optional-defaults to 09 
Optional-defaults to FT 
(AC/DC/PT/SM/SA/MC/MT) 
Optional-defaults to 6 
Optional-defaults to NO 
Optional-specify MFA 
Optional-applies only if 
ADAPTER=MFA and TYPE=MT 
Optional-defaults to NO 
(Specify YES if last BSCLINE statement) 
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Work Sheet 2— Installation and System Generation (continued) 



SYSTEM DEFINITION STATEMENTS 

EXIO device interface definition 

blank EXIODEV ADDRESS= 

MAXDCB= 
RSB= 
END= 

Host communication support 

blank HOSTCOMM DEVICE=BSCA, 



Sensorio device definition 

blank SENSORIO 



System common 

$SYSCOM 



$EDXPTCH 



ADDRESS= 



DEVICE^ 

ADDRESS= 

Al= 

A0= 

Dl 

D0= 

Pl= 

AITYPE= 

LEVEL= 

END= 



CSECT 

QCB 

QCB 

ECB 

ECB 

ENTRY $EDXPTCH 

DATA 128F'0' 



REQUIRED/OPTIONAL/DEFAULTS 



Required 


Optional-defaults to 


Optional-defaults to 


Optional-defaults to NO 


(Specify YES if last EXIODEV statement) 


Required 


Required 


Required-specify IDIO or 4982 


Required 


Optional 


Optional 


Optional 


Optional 


Optional 


Optional-defaults to RELAY 


Optional-defaults to 1 


Optional-defaults to NO 



(Specify YES if last SENSORIO statement) 



System Patch Area 



^ 
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Work Sheet 3 



Work sheet 3 helps you select the software features you need to support your configuration and 
the EDX-related products you are installing as part of your system. 

Work sheet 3 contains the following four columns: 



Column One 



Use this column to indicate the modules you do not wish to include in your supervisor. 

Enter an asterisk (*) in column one for each link-control statement (option, part, ovlarea,, or 
include) that is NOT required to create your supervisor. The asterisk makes the statement a 
comment, and the system does not include in your supervisor any object module with an 
asterisk. Be sure that you include the object modules required to support the processor storage 
characteristics and I/O devices that you defined in work sheet 2, 

Supervisor Object Modules 

Each entry in this column contains: 

• A link-control statement (option, part, volume, ovlarea, include,, or LINK) 

• The object module name. 



Notes 



See Step 3 in Chapter 4, "Select Your Required Support" on page IS-39 for an explanation of 
each link-control statement and object module. 



This column contains numbered notes. Each number refers to a note provided at the end of the 
$LNKCNTL data set. The notes provide a brief explanation for including a specific module. 



Purpose of Module 

This column describes briefly the purpose of each module. 
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Work Sheet 3 (continued) 
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Work Sheet 3— Installation and System Generation 


To include a supervisor object module in your operating system, leave Column One blank. To exclude a 
module, place an asterisk (*) in Column One. 


Column 
one 


Supervisor 
object modules 


Notes 


Purpose of module 




OPTION NOVERLAY 


*25* 


No overlay structure 


Supervisor support— must be first and in partition 1 | 




PARTI 








VOLUME SX4002 




Default volume for include modules 




OVLAREA OVLSTART OVLEND 


*23* 


User defined overlay area 




INCLUDE EDXSYS 


*r 


System tables and work area 




INCLUDE ASMOBJ,EDX002 


*i* 


Output from user system generation 




INCLUDE EDXSVCX 


*i* 


Task supervisor 




INCLUDE $DEBUGNUC 


*n* 


Resident $DEBUG support 




INCLUDE EDXALU 


*^« 


EDL instruction emulator 




INCLUDE EDXSTART 


* ^* 


Initialization & error handler 




INCLUDE SWAITM 


*3* 


Wait oh multiple events 


Timer support— must be in partition 1 I 




INCLUDE EDXTIMER 


*12* 


4955 timer (7840) support 




INCLUDE EDXTIIVIR2 


*12* 


4952/4954/4956 timer support 


EXIO support— must be in partition 1 | 




INCLUDE lOSEXIO 


*3* 


EXIO device control support 




INCLUDE EXIOTRC 


*3* 


EXIO trace option 


Error logging— must be in partition 1 | 




INCLUDE SYSLOG 


*3* 


I/O error logging 




INCLUDE CI RCBUFF 


*16* 


Program/machine check logging 


Optional function support— must be in partition 1 1 




INCLUDE RLOADER 


*17* 


Relocating program loader 




INCLUDE STORMGR 


*3* 


Unmapped storage manager support 




INCLUDE lAMQCB 


*20* 


lAMQCB needed for 1 AM support 




INCLUDE PWRAM80 


*26* 


4980 Power on RAM 


Host communications support— must be in partition 1 


I INCLUDE TPCOM | *14* Host communication support 


Translation tables— must be in partition 1 




INCLUDE TRASCII 


*10* 


1310.2095/2096.7850 ACCA/TTY translation 




INCLUDE TREBASC 


*10* 


1610.2091/2092 ACCA translation 




INCLUDE TREBCD 


*11* 


2741, PROC EBDC translation 




INCLUDE TRCRSP 


*11* 


2741 correspondence translation 


Disk(ette) and tape support— must be grouped together in any partition I 




PARTI 








INCLUDE DISKIO 


*3* 


Basic disk(ette) support 




INCLUDE D49624 


*3* 


4962/4964 disk(ette) support 




INCLUDE D4963A 


*3* 


4963/4967/DDSK-30 subsystem suDDort 




INCLUDE D4966A 


*3* 


4965/4966 disk(ette) support 




INCLUDE D1024 


*3.21* 


1024 bytes/sector 10 support 




INCLUDE D4969A 


*3* 


Basic tape support 


Terminal— must be grouped together in any partition 1 




PART 1 








INCLUDE EDXTIO 


*4* 


Basic terminal support 




INCLUDE MINMSG 


*5* 


Message ID only support 




INCLUDE FULLMSG 


*5* 


Message data set support 




INCLUDE IOS3101 


*7* 


ACCA 31 01 B support 




INCLUDE IOS4979 


*3* 


4978/4979/4980 display support 



0^k 
l^y 



Figure 25. Work Sheet 3 
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£SI?I Series/1 Event Driven Executive 



Worli Sheet 3— Installation and System Generation (cont.) 


Column 
one 


Supervisor 
obiect modules 


Notes 


Purpose of module 




INCLUDE IOS4974 


*3* 


4973/4974/4975/5219/5224/5225 printer support 




INCLUDE lOSACCA 


*4* 


ACCA device handler 




INCLUDE ACCATRC 


*3* 


ACCA trace option 




INCLUDE lOSTERM 


*A,6* 


ACCA/TTY/2741/401 3 support 




INCLUDE lOSTTY 


*3^ 


ASR 33/35/31 01/31 01 CTTY support 




INCLUDE IOS2741 


*3* 


2741 terminal support 




INCLUDE IOS401 3 


*3* 


Digital I/O terminal support 




INCLUDE lOSGPIB 


*3* 


GPIB support 




INCLUDE I0SS1S1 


*3* 


Series/ 1 -Series/1 support 




INCLUDE lOSVIRT 


*3,9* 


Virtual terminal support 




INCLUDE lOSPOOL 


*3' 


Spooling support 




INCLUDE EBFLCVT 


*18* 


EBCDIC/floating point conviersion 


Floating point— may be in any partition I 




PARTI 








INCLUDE EDXFLOAT 


*3* 


Floating point arithmetic 


Queue I/O— may be in any partition 1 




PARTI 








INCLUDE QUEUEIO 


*19* 


Queue processing support 


Bisync comrhunications-may be in any partition /' 1 




PARTI 








INCLUDE BSCAM 


*13* , 


Bisync communication support 




INCLUDE BSCX21 


*27* 


Bisync communication support for X.21 


Sensor Input/output-must be grouped together ir 


1 any par 


tition ... 




PARTI 








INCLUDE SBCOM 


*15^ 


Basic sensor I/O support 




INCLUDE SBAI 


*3* 


Analog input support 




INCLUDE SBAO 


*3* 


Analog output support 




INCLUDE SBDIDO 


*3* 


Digital input/output support 




INCLUDE SBPI 


*3* 


Process interrupt support 


System initialization— must be in partition 1 1 




INCLUDE $PR0G1 


^22* 


User module included in nucleus oen 




INCLUDE IO1024 


*2\* 


1024 1 PL support 


System support - initialization— must be in partiti 


iliiiSif 


; -^«-";. . K ■■ ■. -/ ■ ■-. 




INCLUDE EDXINIT 


^'•*24* :• •^ 


Supervisor initialization: ,*;: 




INCLUDE RW4963ID 


*3*' ■ 


4963 fixed head refresh support 




INCLUDE INITMFA 


.■,^3*v:.. 


MFA attachment initialization 




INCLUDE INITADAP 


»3* :■ ;■■■ 


ALPA and SMIO initialization 




INCLUDE INIT4978 


*3* 


4978/4979 terminal initialization 




INCLUDE INIT4980 


■*3*:.-,: 


4980 display initialization 











\y 



Ky 



vV 
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: Series/1 Event Driven Executive 


Work Sheet 3— Installation and System Generation (cont.) 




Notes 


Purpose of module 


Insert user initialization modules here | 
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Series/1 Event Driven Executive 


Work Sheet 3— Installation and System Generation (cont.) 


Column Supervisor 


Notes 


Purpose of module 


Supervisor code being moved out of partition 1 must be moved to here | 


















































































































































































































































































































































































Location of supervisor 


LINK$EDXNUCT.EDX002 REPLACE END 
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o 
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Work Sheet 4 



Work sheet 4 helps you estimate the size of those portions of the supervisor that are relocated to 
partitions other than partition one and the amount of storage required by programs to execute 
within a partition. 

Work sheet 4 is made up of two parts: A and B. 

Part A Lists the approximate sizes (in bytes) of the supervisor object modules that make 

up the supervisor. This part is used to estimate what portion of each partition the 
supervisor will use. 

Part B Lists the approximate amount of storage required by the supervisor to support 

program products and utility programs. In addition, application programs require a 
certain amount of storage within a partition in order to execute. The algorithms to 
estimate these storage requirements are provided. 



PART A 



Supervisor Object Modules 



^-rv 



Each supervisor object module included in your supervisor requires processor storage. Some of 
these modules must remain in partition 1; others you can locate outside of partition 1. 

Under "Partition One:" on page IS-316 is a list of object modules that must remain in partition 
.1 and their approximate sizes (in bytes). Under "Partition Any:" on page IS-317 are the names 
of object modules that can be located outside of partition 1 , the names of the root segment that 
is left in partition 1 if a module is located outside of partition 1 , and their approximate sizes (in 

bytes). 
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Work Sheet 4 (continued) 



Partition One: The following supervisor object modules must be located in partition 1. 
Compare this list against work sheet 3 and select the object modules that you are including in 
your system. Cross out the modules you are not including, along with their corresponding sizes. 



Total the size column and round the total upward to the next multiple of 256. The resulting 
figure represents the amount of storage required by the supervisor to support these modules. 



MODULE NAME 




SIZE (IN BYTES) 


EDXSYS 




1412 


EDXSVCX 




2758 


$DBUGNUC 




646 


EDXALU 




2360 


EDXSTART 




2190 


SWA 1 TM 




852 


EDXTIMER 




1326 


EDXTIMR2 




1320 


lOSEXIO 




1078 


EXIOTRC 




774 


SYSLOG 




236 


CIRCBUFF 




252 


RLOADER 




5922 


STORMGR 




1352 


lAMQCB 




26 


PWRAM80 




364 


TPCOM 




2020 


TRASCI 1 




514 


TREBASC 




514 


TREBCD 




514 


TRCRSP 




514 


I0102A 




2896 


EDXINIT 




10 


RWi*963ID 




526 


INITMFA 




1398 


INITADAP 




2478 


INITA978 




2338 


INIT4980 




2550 


User initial 


ization modules 








Figure 26. Supervisor Modules Required in Partition 1 



^JLittpujy 
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Work Sheet 4 (continued) 



The linkage editor, $XPSLINK, automatically includes the following initialization modules in your 
supervisor. They are included as overlay segments if you default to overlay structure or as 
resident programs if you include the option noverlay statement. If $XPSLINK includes them as 
resident programs, the initialization modules required for your system are loaded simultaneously 
in supervisor storage. As a result, they increase the amount of storage required by the 
supervisor in partition 1 . 






To determine how much additional storage you require, select the initialization modules you 
require to support the I/O devices attached to your Series/ 1 . Cross out the modules you do not 
need, along with their corresponding sizes. Total the SIZE column; add the resulting figure to the 
total of the size column in Figure 26 on page IS-316 . 



MODULE NAME 


SIZE (IN BYTES.) 


BSCINIT 


578 


CLOKINIT 


188 


DISK IN IT 


163^ 


DSKINITl 


1760 


DSKINIT2 


1194 


EXIOINIT 


66 


INIT4013 


182 


LOAD IN IT 


1568 


SBIOINIT 


180 


S1S1INIT 


274 


STORINIT 


hll 


TAPEINIT 


1704 


TERMINIT 


1714 


T 1 MR 1 N 1 T 


356 


TPINIT 


364 



Partition Any: The following supervisor object modules can be located in partition 2 through 
8 (depending upon your processor). Compare this list against work sheet 3 and select the object 
modules that you are including in your system. Cross out the modules you are not including, 
along with their corresponding sizes. 

If you are generating a single-partition supervisor and leave these modules located in partition 1 , 
cross out the modules you do not need, along with their corresponding sizes. Total the size 
column and add the resulting figure to the total of the size column in Figure 26 on page IS-316. 
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Work Sheets 



Work Sheet 4 (continued) 



If you are generating a multipartition supervisor and move any of these modules into partitions 2 
through 8, you can estimate the amount of storage required within a specific partition by the size 
shown in the size column. As indicated by the horizontal rule, some of these modules MUST be 
grouped together. If you move a group of modules outside of partition 1 , add up the number of 
bytes for the entire group (excluding those not included). 



In addition, $xpslink includes a 'root' segment in partition 1 that corresponds to each supervisor 
object module being located outside of partition 1 . Each root segment requires an amount of 
storage within the supervisor in partition 1. For each object module that you locate outside of 
partition 1, add the amount shown in the ROOT SEGMENT column to the total in the SIZE column 
in Figure 26 on page IS-316. 



MODULE NAME 


SIZE (IN BYTES) 


ROOT SEGMENT 


DISK 10 


\kn 


744 


0102^4 


312 


158 


\ik%lk 


15'*6 


22 


Dit963A 


632 


18 


Dit966A 


99^* 


644 


D4969A 


399'» 


1280 


EDXTIO 


4818 


990 


MINMSG 


Ikk 





FULLMSG 


1362 





I0S3101 


2196 





I0S497A 


1132 


86 


IOS4975A 


734 


13^ 


I0S4979 


2684 


292 


lOSTERM 


676 





lOSACCA 


1296 


392 


ACCATRC 


714 


368 


lOSTTY 


172 


492 


\OSllh\ 


878 


678 


1054013 


282 


3T0 


lOSGPIB 


676 


134 


I0SS1S1 


986 


344 


lOSVIRT 


708 





lOSPOOL 


2050 


206 


EBFLCVT 


1576 





EDXFLOAT 


470 


56 


QUEUE 10 


312 


14 


BSCAM 


4230 


98 


BSCX21 


456 


100 


SBCOM 


140 


12 


SBAI 


640 


62 


SBAO 


76 


14 


SBDIDO 


826 


188 


SBPI 


2 


166 






F^ure 27. Supervisor Modules Not Required in Partition One 
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Work Sheet 4 (continued) 



PARTE 



Program Products 



The following is a list of products that are not part of the supervisor but that use storage in 
partition one if you include them in your system. Read down the list and cross out the products 
you are not including in your system. Total the RESIDENT column and round the total upward to 
the next multiple of 256. The resulting figure represents the amount of storage required by the 
supervisor to support these products. 



Support 


Res ident 


Data set open (DSOPEN) 


1550 


5230 Data Col lection 




Interactive 




1 to 31 entry units 


16384 


31 to 63 entry units 


18432 


System/370 Channel Attach 




$CAPGM (in a partition) 


7500 


link module (in a program) 


3000 


$CHANUT1 (in a partition) 


5400 


+900 per device 


( ) 


Multiple Terminal Manager 


13312 


+522 if indexed support 


( ) 


+552 if 3101 basic 


( ) 


+terminal servers 




(rounded to next 256-byte blocl<) 




834*no. of 4978/i»979 


( ) 


l452*no. of 3101 in block mode 


( ) 


876*no. of ASR 33/35 


( ) 


Support of IO2A bytes per 2200 




sector diskette 




Indexed Access Method 


(3400) 


Version 1 




+625*no. of data sets 


( ) 


+250*no. of application 




programs 


( ) 



The Indexed Access Method Version 2 is supplied as four different packages. You install the 
package you require based on storage function and requirements. Storage requirements vary 
from a minimum of 15K bytes to a maximum of 27K bytes. Control blocks, buffers, and work 
areas require additional storage. Refer to the Indexed Access Method Version 2 Programming 
Directory for further information. 
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Work Sheet 4 (continued) 



Utility Programs 



The following is a list of the approximate sizes of each EDX system utiUty. In planning your 
system, you need to ensure that the partition in which you plan to use a specific utility is large 
enough. To ensure that there is enough storage in a partition to execute a utility, you need to 
take into account the size of the largest utiUty you intend to use and consider its size along with 
program products and applications programs you execute within a specific partition. 



The approximate size in bytes (rounded up to the next 256-byte increment) required by each 
utiUty is as follows: 



UTILITY 


SIZE 




$BSCTRCE 


2560 




$BSCUT1 


7680 




$BSCUT2 


2^046 




$COMPRES 


12800 




$COPY 


13824 




$C0PYUT1 


16128 




$DASDI 


25600 




$DEBUG 


12032 




$DICOMP 


15872 




$DI INTR 


13056 




$DIRECT 


nbkk 




$DISKUT1 


2022^4 




$DISKUT2 


18432 (+1280 if printing error log) 




$DISKUT3 


11008 




$DIUTIL 


13568 




$DUMP 


10764 




$EDIT1 


13824 




$EDIT1N 


17920 




$EDXASM 


19712 (+5632 if assembling TERMINAL statements) 




$EDXLINK 


38912 




$EDXLIST 


13056 




$FONT 


20736 




$FSEDIT 


22528 




$GPIBUT1 


15104 




$HCFUT1 


3328 




$HXUT1 


23808 




$IAMUT1 


19712 (used for Indexed Access Method Versions 1 


and 2) 


$ IMAGE 


12288 




$INITDSK 


30208 




$10TEST 


14336 




$J0B(1UT 


7680 




$JOBUTIL 


1280 




$LOG 


7680 




$MOVEVOL 


5120 




$MSGUT1 


28416 





^~-- 

v.,^** 
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Work Sheet 4 (continued) 



UTILITY 


SIZE 


$PDS 


2816 


$PFMAP 


768 


$PREFIND 


8704 


$PRT2780 


3072 


$PRT3780 


3328 


$RJE2780 


14080 


$RJE3780 


14848 


$RMU 


3584 


$SPLUT1 


5120 


$S1S1UT1 


11520 


$STGUT1 


7424 


$SUBMIT 


8960 


$TAPEUT1 


29110 


$TERMUT1 


11520 


$TERMUT2 


12288 


$TERMUT3 


1280 


$TRACEIO 


14848 


$TRAP 


7424 


$UPDATE 


13056 


$UPDATEH 


9728 


$XPSLINK 


23702 



c 



Application Programs 

Programs Written in Event Driven Language 

Estimate the storage required for an EDL program by totaling the following: 



Program Name: Date: 


Filled Out By: 




1. Number of source statements * 10 


, 


) 


2. Size of large tables and buffers 


= 


) 


3. Graphics subroutines 


= 


) 


4. Formatting subroutines 


= 


) 


5. Formatting instructions 


= 


) 


6. Formatted screen image subroutines 


= 


) 


7. Programs using assembler language code 


= 


) 


8. Extra task control block (for ATTNLIST) 


= 


) 


9. DSOPEN subroutine 


= 


' 1550) 


10. SETEOD subroutine 


= 


280) 


11. $DISKUT3 data management utility 


s 


[ 5200) 


12. $LOADER transient program loader 


= 


( 5704) 


13. $UPCASE 


= 


[ 150) 


14. $4975 
TOTAL 


= 


[ 300) 


( ) 



The following notes supply additional information on how to determine these storage items: 
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Work Sheet 4 (continued) 



O 



Notes: 

1 . The number of source statements includes operation code and instruction parameters plus 
incidental tables and buffers. 

2. The number of words coded for tables and buffers. 



3. Graphics instructions cause subroutines to be added to your program. Add the following for 
the first occurrence of each instruction: 



MODULE 


SIZE (BYTES) 


CONCAT 




30^ 




GIN 




176 




PLOTCB 




16 




PLOTGIN 




20^ 


(+GIN if not already used) 


SCREEN 




k32 




XYPLOT 




368 


(+SCREEN and CONCAT if 
not already used) 


YTPLOT 
TOTAL 


(~ 


368 


(+SCREEN if not already used) 


) 



4. If you use data formatting instructions, the compiler includes FORMATTING SUBROUTINES in 
your program. Add the number indicated for each first occurrence of the following 
specifications included in FORMAT statements referenced by instructions. 






V, J^ 



Instruction 


Specification 


Bytes 


GETEDIT,PUTEDIT or FORMAT 


any 


1014 


GETEDIT 


alphameric 


202 


GETEDIT 


float.pt. F or E 


96 


GETEDIT 


integer 


90 


PUTEDIT 


alphameric 


36 


PUTEDIT 


float.pt. F 


82 


PUTEDIT 


float.pt. E 


82 


PUTEDIT 


integer 


76 


GETEDIT or PUTEDIT 


any parenthetical expression 


22 



5. If you use data formatting instructions, the compiler inserts data areas into your program. 
Add "B" bytes for each occurrence of the following instructions: 



GETEDIT 

B=16+(4*V)+A 

where V=the number of variables in list 
A=6 if ACTION=IO, else A=0 
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Work Sheet 4 (continued) 






PUTEDIT 

B=16+(4*V)+A 

where V=number of variables in list 
A=4 if ACTION=IO, else A=0 



FORMAT 

B=24+(4*L) 

where L=number of elements in FORMAT list 



6. When you include the formatted screen image subroutines, the size of your program 
increases by the amount shown for each subroutine included: 



MODULE 






SIZE (BYTES) 


$IMOPEN 






2600 


$PACK 






112 


$UNPACK 






64 


$IMDTYPE 






116 


$IMGEN (includes $IMDEFN, 


$IMPROT, 


$IMDATA) 


3626 


$IMGEN31 






2060 


$IMGEN49 






1194 


$IMGEN3X 
TOTAL 






3310 


( ) 



7. Programs containing assembler language code require you to include one or more of the 
following subroutines. Add the number of bytes shown for EACH OCCURRENCE of the 
following instructions: 



MODULE 


SIZE 
(BYTES) X 


OCCURRENCE 




$$RETURN (entry point RETURN) 
$$SVC (entry point SVC) 
$EDXATSR (entry points) - 
SETBUSY, SUPEXIT 

TOTAL 


56 X 
20 X 
58 X 


= 




= 




= 








( 


) 



8. When you code a local or a global (or both) attnlist, it generates an extra 128-byte TCB. 

9. When you use dsopen in a program, the size of the program increases by 1500 bytes. 

10. When you use SETEOD in a program, the size of the program increases by 280 bytes. 

1 1 . When you use $diskut3 in a program, it requires an additional 4600 bytes of storage. 
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Work Sheet 4 (continued) 

12. The transient program loader ($loader) requires an area of 4900 bytes which is overlaid 
when the program is loaded. 

13. When you use $UPCASE in a program, it requires an additional 150 bytes of storage. 

14. When you use $4975 in a program, it requires an additional 300 bytes of storage. 

Application Program Storage Estimating 

Programs Written in COBOL 

Estimate the storage required for a COBOL program by adding the following: 

1. 11,000 bytes. 

2. Number of procedure division statements times 12. 

3. Space used by items in DATA DIVISION as indicated on compiler listing if you specified MAP. 

4. Block size of each file times 2. 

Programs Written in PL/I 

Estimate the storage required for a pl/i program by adding the following: 

1. 20,000 bytes. 

2. Number of statements times 52. ( 

Programs Written in FORTRAN 

Estimate the storage required for a FORTRAN program by adding the following: 

1. 11,000 bytes. 

2. Sum of the number of bytes shown in TOTAL PROGRAM REQUIREMENTS at the end of the 
compiler Usting for each routine. 

3. Space used by edl driver program. 
Programs Written in Pascal 

Estimate the storage required for a Pascal program by adding the following: 

1. 15,000 bytes. 

2. The number of bytes shown in TOTAL PROGRAM REQUIREMENTS at the end of the compiler 
Usting for each module. 



v# 
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Glossary of Terms and Abbreviations 



jr>, 



This glossary defines terms and abbreviations used in the Series/ 1 Event Driven Executive software publications. All software and 
hardware terms pertain to EDX. This glossary also serves as a supplement to the IBM Data Processing Glossary, GC20-1699. 



$SYSLOGA, $SYSLOGB. The name of the alternate system 
logging device. This device is optional but, if defined, should be 
a terminal with keyboard capability, not just a printer. 

$SYSLOG. The name of the system logging device or operator 
station; must be defined for every system. It should be a terminal 
with keyboard capability, not just a printer. 

$SYSPRTR. The name of the system printer. 

abend. Abnormal end-of-task. Termination of a task prior to its 
completion because of an error condition that cannot be resolved 
by recovery facilities while the task is executing. 

ACCA. See asynchronous communications control adapter. 

address key. Identifies a set of Series/ 1 segmentation registers 
and represents an address space. It is one less than the partition 
number. 

address space. The logical storage identified by an address key. 
An address space is the storage for a partition. 

application program manager. The component of the Multiple 
Terminal Manager that provides the program management 
facilities required to process user requests. It controls the 
contents of a program area and the execution of programs within 
the area. 

application program stub. A collection of subroutines that are 
appended to a program by the linkage editor to provide the link 
from the application program to the Multiple Terminal Manager 
facilities. 



asynchronous communications control adapter. An ASCII 
terminal attached via #1610, #2091 with #2092, or #2095 with 
#2096 adapters. 

attention key. The key on the display terminal keyboard that, if 
pressed, tells the operating system that you are entering a 
command. 

attention list. A series of pairs of 1 to 8 byte EBCDIC strings 
and addresses pointing to EDL instructions. When the attention 
key is pressed on the terminal, the operator can enter one of the 
strings to cause the associated EDL instructions to be executed. 

backup. A copy of data to be used in the event the original data 
is lost or damaged. 

base record slots. Space in an indexed file that is reserved for 
based records to be placed. 

base records. Records are placed into an indexed file while in 
load mode or inserted in process mode with a new high key. 

basic exchange format. A standard format for exchanging data 
on diskettes between systems or devices. 

binary synchronous device data block (BSCDDB). A control 
block that provides the information to control one Series /I 
Binary Synchronous Adapter. It determines the line 
characteristics and provides dedicated storage for that line. 
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block. (1) See data block or index block. (2) In the Indexed 
Method, the unit of space used by the access method to contain 
indexes and data. 

block mode. The transmission mode in which the 3101 ^Display 
Station transmits a data data stream, which has been edited and 
stored, when the SEND key is pressed. 

BSCAM. See binary synchronous communications access 
method. 

binary synchronous communications access method. A form 
of binary synchronous I/O control used by the Series/ 1 to 
perform data communications between local or remote stations. 

BSCDDB. See binary synchronous device data block. 

buffer. An area of storage that is temporarily reserved for use in 
performing an input/output operation, into which data is read or 
from which data is written. See input buffer and output buffer. 

bypass label processing. Access of a tape without any label 
processing support. 

CCS. See terminal control block. 

central buffer. The buffer used by the Indexed Access Method 
for all transfers of information between main storage and indexed 
files. 

character image. An alphabetic, numeric, or special character 
defined for an IBM 4978 Display Station. Each character image 
is defined by a dot matrix that is coded into eight bytes. 

character image table. An area containing the 256 character 
images that can be defined for an IBM 4978 Display Station. 
Each character image is coded into eight bytes, the entire table of 
codes requiring 2048 bytes of storage. 

character mode. The transmission mode in which the 3101 
Display Station immediately sends a character when a keyboard 
key is pressed. 

cluster. In an indexed file, a group of data blocks that is pointed 
to from the same primary- level index block, and includes the 
primary- level index block. The data records and blocks 
contained in a cluster are logically contiguous, but are not 
necessarily physically contiguous. 

COD (change of direction). A character used with ACCA 
terminal to indicate a reverse in the direction of data movement. 

cold start. Starting the spool facility by erasing any spooled jobs 
remaining in the spool data set from any previous spool session. 

command. A character string from a source external to the 
system that represents a request for action by the system. 

common area. A user-defined data area that is mapped into the 
partitions specified on the SYSTEM definition statement. It can 



be used to contain control blocks or data that will be accessed by 
more than one program. 

completion code. An indicator that reflects the status of the 
execution of a program. The completion code is displayed or 
printed on the program's output device. 

constant. A value or address that remains unchanged thoughout 
program execution. 

controller. A device that has the capability of configuring the 
GPIB bus by designating which devices are active, which devices 
are listeners, and which device is the talker. In Series/ 1 GPIB 
implementation, the Series /I is always the controller. 

conversion. See update. 

control station. In BSCAM communications, the station that 
supervises a multipoint connection, and performs polling and 
selection of its tributary stations. The status of control station is 
assigned to a BSC line during system generation. 

cross-partition service. A function that accesses data in two 
partitions. 

cross-partition supervisor. A supervisor in which one or more 
supervisor modules reside outside of partition 1 (address space 
0). 

data block. In an indexed file, an area that contains control 
information and data records. These blocks are a multiple of 256 
bytes. 

data record. In an indexed file, the records containing customer 
data. 

data set. A group of records within a volume pointed to by a 
directory member entry in the directory for the volume. 

data set control block (DSCB). A control block that provides 
the information required to access a data set, volume or directory 
using READ and WRITE. 

data set shut down. An indexed data set that has been marked 
(in main storage only) as unusable due to an error. 

DCE. See directory control entry. 

device data block (DDB). A control block that describes a disk 
or diskette volume. 

direct access. (1 ) The access method used to READ or WRITE 
records on a disk or diskette device by specifying their location 
relative the beginning of the data set or volume. (2) In the 
Indexed Access Method, locating any record via its key without 
respect to the previous operation. (3) A condition in terminal I/O 
where a READTEXT or a PRINTEXT is directed to a buffer which 
was previously enqueued upon by an I0C6. 
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directory. (1) A series of contiguous records in a volume that 
describe the contents in terms of allocated data sets and free 
space. (2) A series of contiguous records on a device that 
describe the contents in terms of allocated volumes and free 
space. (3) For the Indexed Access Method Version 2, a data set 
that defines the relationship between primary and secondary 
indexed files (secondary index support). 

directory control entry (DCE). The first 32 bytes of the first 
record of a directory in which a description of the directory is 
stored. 

directory member entry (DIVIE). A 32-byte directory entry 
describing an allocated data set or volume. 

display station. An IBM 4978, 4979, or 3101 display terminal or 
similar terminal with a keyboard and a video display. 

DME. See directory member entry. 

DSCB. See data set control block. 

dynamic storage. An increment of storage that is appended to a 
program when it is loaded. 

end-of-data indicator. A code that signals that the last record of 
a data set has been read or written. End-of-data is determined 
by an end-of-data pointer in the DME or by the physical end of 
the data set. 

ECB. See event control block. 

EDL. See Event Driven Language. 

emulator. The portion of the Event Driven Executive supervisor 
that interprets EDL instructions and performs the function 
specified by each EDL statement. 

end-of-tape (EOT). A reflective marker placed near the end of a 
tape and sensed during output. The marker signals that the tape 
is nearly full. 

enter key. The key on the display terminal keyboard that, if 
pressed, tells the operating system to read the information you 
entered. 

event control block (ECB). A control block used to record the 
status (occurred or not occurred) of an event; often used to 
synchronize the execution of tasks. ECBs are used in conjunction 
with the WAIT and POST instructions. 

Event Driven Language (EDL). The language for input to the 
Event Driven Executive compiler ($EDXASM), or the Macro and 
Host assemblers in conjunction with the Event Driven Executive 
macro libraries. The output is interpreted by the Event Driven 
Executive emulator. 

EXIO (execute input or output). An EDL facility that provides 
user controlled access to Series/ 1 input/output devices. 



external label. A label attached to the outside of a tape that 
identifies the tape visually. It usually contains items of 
identification such as file name and number, creation data, 
number of volumes, department number, and so on. 

external name (EXTRN). The 1- to 8-character symbolic 
EBCDIC name for an entry point or data field that is not defined 
within the module that references the name. 

FCA. See file control area. 

FOB. See file control block. 

file. A set of related records treated as a logical unit. Although 
file is often used interchangeably with data set, it usually refers to 
an indexed or a sequential data set. 

file control area (FCA). A Multiple Terminal Manager data area 
that describes a file access request. 

file control block (FCB). The first block of an indexed file. It 
contains descriptive information about the data contained in the 
file. 

file control block extension. The second block of an indexed 
file. It contains the file definition parameters used to define the 
file. 

file manager. A collection of subroutines contained within the 
program manager of the Multiple Terminal Manager that provides 
common support for ail disk data transfer operations as needed 
for transaction-oriented application programs. It supports 
indexed and direct files under the control of a single callable 
function. 

floating point. A positive or negative number that can have a 
decimal point. 

formatted screen image. A collection of display elements or 
display groups (such as operator prompts and field input names 
and areas) that are presented together at one time on a display 
device. 

free pool. In an indexed data set, a group of blocks that can be 
used for either data blocks or index blocks. These differ from 
other free blocks in that these are not initially assigned to specific 
logical positions in the file. 

free space. In an indexed file, records blocks that do not 
currently contain data, and are available for use. 

free space entry (FSE). An 8-byte directory entry defining an 
area of free space within a volume or a device. 

FSE. See free space entry. 

general purpose interface bus. The IEEE Standard 488-1975 
that allows various interconnected devices to be attached to the 
GPIB adapter (RPQ D021 1 8). 
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GPIB. See general purpose interface bus. 

group. A unit of 100 records in the spool data set allocated to a 
spool job. 

H exchange format. A standard format for exchanging data on 
diskettes between systems or devices. 

host assembler. The assembler licensed program that executes 
in a 370 (host) system and produces object output for the 
Series/ 1. The source input to the host assembler is coded in 
Event Driven Language or Series/ 1 assembler language. The 
host assembler refers to the System /370 Program Preparation 
Facility (5798- NNQ). 

host system. Any system whose resources are used to perform 
services such as program preparation for a Series/ 1. It can be 
connected to a Series/ 1 by a communications link. 

lACB. See indexed access control block. 

lAR. See instruction address register. 

ICB. See indexed access control block. 

IIB. See interrupt information byte. 

image store. The area in a 4978 that contains the character 
image table. 

immediate data. A self-defining term used as the operand of an 
instruction. It consists of numbers, messages or values which 
are processed directly by the computer and which do not serve as 
addresses or pointers to other data in storage. 

index. In an indexed file, an ordered collection of pairs of keys 
and pointers, used to sequence and locate records. 

index block. In an indexed file, an area that contains control 
information and index entries. These blocks are a multiple of 256 
bytes. 

indexed access control block (lACB/ICB). The control block 
that relates an application program to an indexed file. 

indexed access method. An access method for direct or 
sequential processing of fixed -length records by use of a 
record's key. 

indexed data set. Synonym for indexed file. 

indexed file. A file specifically created, formatted and used by 
the Indexed Access Method. An indexed file is sometimes called 
an indexed data set. 

index entry. In an indexed file, a key-pointer pair, where the 
pointer is used to locate a lower- level index block or a data block. 



index register (#1, #2). Two words defined in EDL and 
contained in the task control block for each task. They are used 
to contain data or for address computation. 

input buffer. (1) See buffer. (2) In the Multiple Terminal 
Manager, an area for terminal input and output. 

input output control block (lOCB). A control block containing 
information about a terminal such as the symbolic name, size and 
shape of screen, the size of the forms in a printer, or an optional 
reference to a user provided buffer. 

instruction address register (lAR). The pointer that identifies 
the machine instruction currently being executed. The Series/ 1 
maintains a hardware lAR to determine the Series/ 1 assembler 
instruction being executed. It is located in the level status block 
(LSB). 

integer. A positive or negative number that has no decimal 
point. 

interactive. The mode in which a program conducts a 
continuous dialogue between the user and the system. 

internal label. An area on tape used to record identifying 
information (similar to the identifying information placed on an 
external label). Internal labels are checked by the system to 
ensure that the correct volume is mounted. 

interrupt information byte (IIB). In the Multiple Terminal 
Manager, a word containing the status of a previous input/output 
request to or from a terminal. 

invoke. To load and activate a program, utility, procedure, or 
subroutine into storage so it can run. 

job. A collection of related program execution requests 
presented in the form of job control statements, identified to the 
jobstream processor by a JOB statement. 

job control statement. A statement in a job that specifies 
requests for program execution, program parameters, data set 
definitions, sequence of execution, and, in general, describes the 
environment required to execute the program. 

job stream processor. The job processing facility that reads job 
control statements and processes the requests made by these 
statements. The Event Driven Executive job stream processor is 
$JOBUTIL 

jumper. (1 ) A wire or pair of wires which are used for the 
arbitrary connection between two circuits or pins in an 
attachment card. (2) To connect wire(s) to an attachment card or 
to connect two circuits. 

key. In the Indexed Access Method, one or more consecutive 
characters used to identify a record and establish its order with 
respect to other records. See also key field. 
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key field. A field, located in the same position in each record of 
an indexed file, whose content is used for the key of a record. 

level status block (LSB). A Series/ 1 hardware data area that 
contains processor status. This area is eleven words in length. 

library. A set of contiguous records within a volume. It contains 
a directory, data sets and /or available space. 

line. A string of characters accepted by the system as a single 
input from a terminal; for example, all characters entered before 
the carriage return on the teletypewriter or the ENTER key on the 
display station is pressed. 

link edit. The process of resolving external symbols in one or 
more object modules. A link edit is performed with $EDXLINK 
whose output is a loadable program. 

listener. A controller or active device on a GPIB bus that is 
configured to accept information from the bus. 

load mode. In the Indexed Access Method, the mode in which 
records are loaded into base record slots in an indexed file. 

load module. A single module having cross references resolved 
and prepared for loading into storage for execution. The module 
is the output of the $UPDATE or $UPDATEH utility. 

load point. (1) Address in the partition where a program is 
loaded. (2) A reflective marker placed near the beginning of a 
tape to indicate where the first record is written. 

lock. In the Indexed Access Method, a method of indicating that 
a record or block is in use and is not available for another request. 

logical screen. A screen defined by margin settings, such as the 
TOPM, BOTM, LEFTM and RIGHTM parameters of the 
TERMINAL or lOCB statement. 

LSB. See level status block. 

mapped storage. The processor storage that you defined on the 
SYSTEM statement during system generation. 

member. A term used to identify a named portion of a 
partitioned data set (PDS). Sometimes member is also used as a 
synonym for a data set. See data set. 

menu. A formatted screen image containing a list of options. 
The user selects an option to invoke a program. 

menu-driven. The mode of processing in which input consists of 
the responses to prompting from an option menu. 

message. In data communications, the data sent from one 
station to another in a single transmission. Stations 
communication with a series of exchanged messages. 

multifile volume. A unit of recording media, such as tape reel or 
disk pack, that contains more than one data file. 



multiple terminal manager. An Event Driven Executive licensed 
program that provides support for transaction-oriented 
applications on a Series/ 1. It provides the capability to define 
transactions and manage the programs that support those 
transactions. It also manages multiple terminals as needed to 
support these transactions. 

multivolume file. A data file that, due to its size, requires more 
than one unit of recording media (such as tape reel or disk pack) 
to contain the entire file. 



new high key. 

file. 



A key higher than any other key in an indexed 



nonlabeled tapes. Tapes that do not contain identifying labels 
(as in standard labeled tapes) and contain only files separated by 
tapemarks. 

null character. A user-defined character used to define the 
unprotected fields of a formatted screen. 

option selection menu. A full screen display used by the 
Session Manager to point to other menus or system functions, 
one of which is to be selected by the operator. (See primary 
option menu and secondary option menu.) 

output buffer. (1) See buffer. (2) In the Multiple Terminal 
Manager, an area used for screen output and to pass data to 
subsequent transaction programs. 

overlay. The technique of reusing a single storage area allocated 
to a program during execution. The storage area can be reused 
by loading it with overlay programs that have been specified in 
the PROGRAM statement of the program or by calling overlay 
segments that have been specified in the OVERLAY statement of 
$EDXLINK. 

overlay area. A storage area within a program reserved for 
overlay programs specified in the PROGRAM statement or 
overlay segments specified in the OVERLAY statement in 
$EDXLINK. 

overlay program. A program in which certain control sections 
can use the same storage location at different times during 
execution. An overlay program can execute concurrently as an 
asynchronous task with other programs and is specified in the 
EDL PROGRAM statement in the main program. 

overlay segment. A self-contained portion of a program that is 
called and sequentially executes as a synchronous task. The 
entire program that calls the overlay segment need not be 
maintained in storage while the overlay segment is executing. An 
overlay segment is specified in the OVERLAY statement of 
$EDXLINK or $XPSLINK (for initialization modules). 

overlay segment area. A storage area within a program or 
supervisor reserved for overlay segments. An overlay segment 
area is specified with the OVLAREA statement of $EDXLINK. 
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parameter selection menu. A full screen display used by the 
Session Manager to indicate the parameters to be passed to a 
program. 

partition. A contiguous fixed-sized area of storage. Each 
partition is a separate address space. 

performance volume. A volume whose name is specified on 
the DISK definition statement so that its address is found during 
IPL, increasing system performance when a program accesses 
the volume. 

physical timer. Synonym for timer (hardware). 

polling. In data communications, the process by which a 
multipoint control station asks a tributary if it can receive 
messages. 

precision. The number of words in storage needed to contain a 
value in an operation. 

prefind. To locate the data sets or overlay programs to be used 
by a program and to store the necessary information so that the 
time required to load the prefound items is reduced. 

primary file. An indexed file containing the data records and 
primary index. 

primary file entry. For the Indexed Access Method Version 2, 
an entry in the directory describing a primary file. 

primary index. The index portion of a primary file. This is used 
to access data records when the primary key is specified. 

primary key. In an indexed file, the key used to uniquely identify 
a data record. 

primary-level index block. In an indexed file, the lowest level 
index block. It contains the relative block numbers (RBNs) and 
high keys of several data blocks. See cluster. 

primary menu. The program selection screen displayed by the 
Multiple Terminal Manager. 

primary option menu. The first full screen display provided by 
the Session Manager. 

primary station. In a Series/ 1 to Series/ 1 attachment, the 
processor that control communication between the two 
computers. Contrast with secondary station. 

primary task. The first task executed by the supervisor when a 
program is loaded into storage. It is identified by the PROGRAM 
statement. 

priority. A combination of hardware interrupt level priority and a 
software ranking within a level. Both primary and secondary 
tasks will execute asynchronously within the system according to 
the priority assigned to them. 



process mode. In the Indexed Access Method, the mode in 
which records can be retrieved, updated, inserted or deleted. 

processor status word (PSW). A 1 6-bit register used to (1 ) 
record error or exception conditions that may prevent further 
processing and (2) hold certain flags that aid in error recovery. 

program. A disk- or diskette-resident collection of one or more 
tasks defined by a PROGRAM statement; the unit that is loaded 
into storage. (See primary task and secondary task.) 

program header. The control block found at the beginning of a 
program that identifies the primary task, data sets, storage 
requirements and other resources required by a program. 

program/storage manager. A component of the Multiple 
Terminal Manager that controls the execution and flow of 
application programs within a single program area and contains 
the support needed to allow multiple operations and sharing of 
the program area. 

protected field. A field in which the operator cannot use the 
keyboard to enter, modify, or erase data. 

PSW. See processor status word. 

QCB. See queue control block. 

QD. See queue descriptor. 

QE. See queue element. 

queue control block (QCB). A data area used to serialize access 
to resources that cannot be shared. See serially reusable 
resource. 

queue descriptor (QD). A control block describing a queue built 
by the DEFINEQ instruction. 

queue element (QE). An entry in the queue defined by the 
queue descriptor. 

quiesce. To bring a device or a system to a halt by rejection of 
new requests for work. 

quiesce protocol. A method of communication in one direction 
at a time. When sending node wants to receive, it releases the 
other node from its quiesced state. 

record. (1 ) The smallest unit of direct access storage that can be 
accessed by an application program on a disk or diskette using 
READ and WRITE. Records are 256 bytes in length. (2) In the 
Indexed Access Method, the logical unit that is transferred 
between $IAM and the user's buffer. The length of the buffer is 
defined by the user. (3) In BSCAM communications, the portions 
of data transmitted in a message. Record length (and, therefore, 
message length) can be variable. 

recovery. The use of backup data to re-create data that has 
been lost or damaged. 
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reflective marker. A small adhesive marker attached to the 
reverse (nonrecording) surface of a reel of magnetic tape. 
Normally, two reflective markers are used on each reel of tape. 
One indicates the beginning of the recording area on the tape 
(load point), and the other indicates the proximity to the end of 
the recording area (eot) on the reel. 

relative block address (RBA). The location of a block of data on 
a 4967 disk relative to the start of the device. 

relative record number. An integer value identifying the 
position of a record in a data set relative to the beginning of the 
data set. The first record of a data set is record one, the second 
is record two, the third is record three. 

relocation dictionary (RLD). The part of an object module or 
load module that is used to identify address and name constants 
that must be adjusted by the relocating loader. 

remote management utility control block (RCB). A control 
block that provides information for the execution of remote 
management utility functions. 

reorganize. The process of copying the data in an indexed file to 
another indexed file in a manner that rearranges the data for more 
optimum processing and free space distribution. 

restart. Starting the spool facility w the spool data set contains 
jobs from a previous session. The jobs in the spool data set can 
be either deleted or printed when the spool facility is restarted. 

return code. An indicator that reflects the results of the 
execution of an instruction or subroutine. The return code is 
usually placed in the task code word (at the beginning of the task 
control block). 

roll screen. A display screen which is logically segmented into 
an optional history area and a work area. Output directed to the 
screen starts display at the beginning of the work area and 
continues on down in a line-by-line sequence. When the work 
area gets full, the operator presses enter/send and its contents 
are shifted into the optional history area and the work area itself 
is erased. Output now starts again at the beginning of the work 
area. 

SBIOCB. See sensor based I/O control block. 



secondary key. For the Indexed Access Method Version 2, the 
key used to uniquely identify a data record. 

secondary option menu. In the Session Manager, the second in 
a series of predefined procedures grouped together in a 
hierarchical structure of menus. Secondary option menus provide 
a breakdown of the functions available under the session 
manager as specified on the primary option menu. 

secondary task. Any task other than the primary task. A 
secondary task must be attached by a primary task or another 
secondary task. 

secondary station. In a Series /I to Series/ 1 attachment, the 
processor that is under the control of the primary station. 

sector. The smallest addressable unit of storage on a disk or 
diskette. A sector on a 4962 or 4963 disk is equivalent to an 
Event Driven Executive record. On a 4964 or 4966 diskette, two 
sectors are equivalent to an Event Driven Executive record. 

selection. In data communications, the process by which the 
multipoint control station asks a tributary station if it is ready to 
send messages. 

self-defining term. A decimal, integer, or character that the 
computer treats as a decimal, integer, or character and not as an 
address or pointer to data in storage. 

sensor based I/O control block (SBIOCB). A control block 
containing information related to sensor I/O operations. 

sequential access. The processing of a data set in order of 
occurrence of the records in the data set. (1 ) In the Indexed 
Access Method, the processing of records in ascending collating 
sequence order of the keys. (2) When using read/write, the 
processing of records in ascending relative record number 
sequence. 

serially reusable resource (SRR). A resource that can only be 
accessed by one task at a time. Serially reusable resources are 
usually managed via (1) a qcb and enq/deq statements or (2) an 
ECB and wait/post statements. 

service request. A device generated signal used to inform the 
GPiB controller that service is required by the issuing device. 



second-level index block. In an indexed data set, the 
second-lowest level index block. It contains the addresses and 
high keys of several primary-level index blocks. 

secondary file. See secondary index. 

secondary index. For the Indexed Access Method Version 2, an 
indexed file used to access data records by their secondary keys. 
Sometimes called a secondary file. 

secondary index entry. For the Indexed Access Method 
Version 2, this an an entry in the directory describing a secondary 
index. 



session manager. A series of predefined procedures grouped 
together as a hierarchical structure of menus from which you 
select the utility functions, program preparation facilities, and 
language processors needed to prepare and execute application 
programs. The menus consist of a primary option menu that 
displays functional groupings and secondary option menus that 
display a breakdown of these functional groupings. 

shared resource. A resource that can be used by more than one 
task at the same time. 
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shut down. See data set shut down. 

source module/program. A collection of instructions and 
statements that constitute the input to a compiler or assembler. 
Statements may be created or modified using one of the text 
editing facilities. 

spool job. The set of print records generated by a program 
(including any overlays) while engueued to a printer designated as 
a spool device. 

spool session. An invocation and termination of the spool 
facility. 

spooling. The reading of input data streams and the writing of 
output data streams on storage devices, concurrently with job 
execution, in a format convenient for later processing or output 
operations. 

SRQ. See service request. 

stand-alone dump. An image of processor storage written to a 
diskette. 

stand-alone dump diskette. A diskette supplied by IBM or 
created by the $DASDI utility. 

standard labels. Fixed length 80-character records on tape 
containing specific fields of information (a volume label 
identifying the tape volume, a header label preceding the data 
records, and a trailer label following the data records). 

static screen. A display screen formatted with predetermined 
protected and unprotected areas. Areas defined as operator 
prompts or input field names are protected to prevent accidental 
overlay by input data. Areas defined as input areas are not 
protected and are usually filled in by an operator. The entire 
screen is treated as a page of information. 

station. In BSCAM communications, a BSC line attached to the 
Series/1 and functioning in a point-to-point or multipoint 
connection. Also, any other terminal or processor with which the 
Series/ 1 communicates. 

subroutine. A sequence of instructions that may be accessed 
from one or more points in a program. 

supervisor. The component of the Event Driven Executive 
capable of controlling execution of both system and application 
programs. 

system configuration. The process of defining devices and 
features attached to the Series/ 1 . 

SYSGEN. See system generation. 

system generation. The processing of defining I/O devices and 
selecting software options to create a supervisor tailored to the 
needs of a specific Series/1 hardware configuration and 
application. 



system partition. The partition that contains the root segment 
of the supervisor (partition number 1, address space 0). 

talker. A controller or active device on a GPIB bus that is 
configured to be the source of information (the sender) on the 
bus. 

tape device data block (TDB). A resident supervisor control 
block which describes a tape volume. 

tapemark. A control character recorded on tape used to 
separate files. 

task. The basic executable unit of work for the supervisor. Each 
task is assigned its own priority and processor time is allocated 
according to this priority. Tasks run independently of each other 
and compete for the system resources. The first task of a 
program is the primary task. All tasks attached by the primary 
task are secondary tasks. 

task code word. The first two words (32 bits) of a task's TCB; 
used by the emulator to pass information from system to task 
regarding the outcome of various operations, such as event 
completion or arithmetic operations. 

task control block (TCB). A control block that contains 
information for a task. The information consists of pointers, save 
areas, work areas, and indicators required by the supervisor for 
controlling execution of a task. 

task supervisor. The portion of the Event Driven Executive that 
manages the dispatching and switching of tasks. 

TCB. See task control block. 

terminal. A physical device defined to the EDX system using the 
TERMINAL configuration statement. EDX terminals include 
directly attached IBM displays, printers and devices that 
communicate with the Series/ 1 in an asynchronous manner. 

terminal control block (CCB). A control block that defines the 
device characteristics, provides temporary storage, and contains 
links to other system control blocks for a particular terminal. 

terminal environment block (TEB). A control block that 
contains information on a terminal's attributes and the program 
manager operating under the Multiple Terminal Manager. It is 
used for processing requests between the terminal servers and 
the program manager. 

terminal screen manager. The component of the Multiple 
Terminal Manager that controls the presentation of screens and 
communications between terminals and transaction programs. 

terminal server. A group of programs that perform all the 
input/output and interrupt handling functions for terminal devices 
under control of the Multiple Terminal Manager. 
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terminal support. The support provided by EDX to manage and 
control terminals. See terminal. 

timer. The timer features available with the Series/1 processors. 
Specifically, the 7840 Timer Feature card (4955 only) or the native 
timer (4952, 4954, and 4956). Only one or the other is supported 
by the Event Driven Executive. 

trace range. A specified number of instruction addresses within 
which the flow of execution can be traced. 

transaction oriented applications. Program execution driven by 
operator actions, such as responses to prompts from the system. 
Specifically, applications executed under control of the Multiple 
Terminal Manager. 

transaction program. See transaction-oriented applications. 

transaction selection menu. A Multiple Terminal Manager 
display screen (menu) offering the user a choice of functions, 
such as reading from a data file, displaying data on a terminal, or 
waiting for a response. Based upon the choice of option, the 
application program performs the requested processing 
operation. 

tributary station. In BSCAM communications, the stations 
under the supervision of a control station in a multipoint 
connection. They respond to the control station's polling and 
selection. 

unmapped storage. The processor storage in your processor 
that you did not define on the SYSTEM statement during system 
generation. 

unprotected field. A field in which the operator can use the 
keyboard to enter, modify or erase data. Also called 
non-protected field. 



update. (1 ) To alter the contents of storage or a data set. (2) To 
convert object modules, produced as the output of an assembly 
or compilation, or the output of the linkage editor, into a form that 
can be loaded into storage for program execution and to update 
the directory of the volume on which the loadable program is 
stored. 

user exit. (1 ) Assembly language instructions included as part of 
an EDL program and invoked via the USER instruction. (2) A 
point in an IBM-supplied program where a user written routine 
can be given control. 

variable. An area in storage, referred to by a label, that can 
contain any value during program execution. 

vary offline. (1 ) To change the status of a device from online to 
offline. When a device is offline, no data set can be accessed on 
that device. (2) To place a disk or diskette in a state where it is 
unknown by the system. 

vary online. To place a device in a state where it is available for 
use by the system. 



vector. An ordered set or string of numbers. 

volume. A disk, diskette, or tape subdivision defined using 
$INITDSKor$TAPEUT1. 

volume descriptor entry (VDE). A resident supervisor control 
block that describes a volume on a disk or diskette. 

volume label. A label that uniquely identifies a single unit of 
storage media. 
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Special Characters 

$DBUGNUC module description IS-54 
$DISKUT1 utility 

used with $MIGAID utility IS- 126 
$EDXDEF data set 

assemble statements IS- 104 

edit procedure IS-81 

example contents IS-82 

hardware configuration IS-81 

system definition statements IS-81 
$EDXLINK utility 

control statements IS-51 

use during system generation IS- 105 
$EDXNUC supervisor data set 

allocating IS-62 

installing IS-15 
$INITDSK utility 

allocate 

volumes for system installation IS-21 

initialize 

volume directories for system installation IS-21 

IPLtext IS-107, IS-110 

used in Version 5 conversion IS- 121 

write 
$JOBUTIL utility 

$SUPPREP data set IS-99 

assemble definition statements IS-99 

edit procedure IS- 100 

error conditions IS- 106 

link-edit supervisor modules IS-99 

procedure file IS-99 



required data sets IS-99 
$LNKCNTL 

See link control data set 
$MEMDISK utility 

required support IS-55 
$MIGAID utility 

commands IS-128 

description IS- 126 

error handling IS-134 

examples IS- 129 

overview IS-119 
$MIGCOPY utility 

description IS- 140 

examples IS- 141 

overview IS-119 
$MIGRATE utility 

description IS- 139 

overview IS -^119 
$SSINIT utility 

description IS- 126 

overview IS-119 
$S UP PREP data set 

description IS-99 

edit procedure IS- 100 

execute IS- 104 

job procedure file IS-99 
$SYSCOM system common data area 

define IS-50 

description IS-50 
$SYSLOG system logging device IS- 185 
$SYSLOGA alternate system logging device IS- 185 
$SYSLOGB alternate system logging device IS- 186 
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$SYSPRTR system printer IS- 186 
$TAPEUT1 utility 

used in Version 5 conversion IS- 124 
$XPSLINK linkage editor 

$EDXLINK program IS-105 

$XPSPOST program IS-106 

$X PS PRE program IS-105 

control statements IS-51 

description IS-50 

execute IS- 104 
$XPSPOST link-edit postprocessor IS-106 
$XPSPRE link-edit preprocessor IS-105 



ACCA 

terminals 

defined by TERMINAL statement 18-214 
TERMINAL statement example IS-223 
transmission codes IS-215 
ACCATRC module description IS-58 
ADAPTER statement 

description IS-47, IS- 146 
examples IS- 148 
operands IS-147 
syntax IS-147 
allocate 
data set 

for system generation IS-79 
to verify installation IS-33 
directories 

for system generation IS-21 
volume 

for system generation IS-21 
ALPA 

See Printer Attachment - 5200 Series (#5640) 
ALPA attachment, define IS- 146 
alternate system logging device IS-37, IS- 185, IS- 186 
analog output 

SENSORIO statement IS- 160 
ASCII terminal 

codes IS- 184 
configuring IS- 183 

TERMINAL statement examples IS-232 
assemble 

system definition statements IS- 104 
verification program IS-35, IS-111 
automatic 

start of application program IS-60 
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back up 

cu rrent system I S - 1 9 
basic supervisor and emulator 

See supervisor 
batch job processing 

See $JOBUTIL utility 
binary synchronous communications (BSC) 

line, define IS-49 

supervisor object module IS-60 
binary synchronous communications access method (BSCAM) 

BSC lines to supervisor IS- 150 

define 
BSC lines 

defining to supervisor IS- 150 
BSCAM module description IS-60 
BSCINIT module description IS-67 
BSCLINE statement 

description IS-49, IS- 150 

examples IS- 153 

operands IS- 150 

storage requirements IS-291 

syntax IS- 150 



bus 



See general purpose interface bus 



CALCDEMO verification program 

execute IS-112 

link-edit iS-112 

required data sets IS-33 
CALCSRC verification program 

assemble IS-111 

verify tailored operating system IS-1 1 1 
characteristics of storage IS-40 
CIRCBUFF module description IS-55 
CLOKINIT module description IS-67 
COBOL, storage requirements IS-324 
code 

the TERMINAL statement IS-186 
common data area 

See $SYSCOM system common data area 
configuring your system IS-42 
convert to Version 5 

$MIGRATE IS-139 

overview IS-1 18 

special considerations IS-1 19 

utilities 

$MIGAID IS-126 
$MIGCOPY IS-140 
$SSINIT IS-126 
copy 

basic utilities IS-25 

M FA initializer diskette IS-1 15 

product diskettes 

starter system IS- 1 5 

program preparation modules IS-30 
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program preparation utilities IS-30 
starter system IS-25 
support modules IS-25, IS-28 
create 

multipartition supervisor IS-51 
tailored operating system IS-77 
cross- partition stack, define IS- 164 
CSECT list, supervisor 18-275 
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data set 

date 

format IS- 164 

DDSK-30 Disk 

defined with DISK statement IS-154 
storage requirements IS-289 
support module IS-56 

DDSK-60 Disk 

defined with DISK statement IS-154 
support module IS-56 

default volume for system generation IS-53 

define 

#7840 timer feature IS-47 

ACCA-type terminals IS-214 

ALPA attachment IS-47, IS-146 

binary synchronous line IS-49, IS- 150 

cross- partition stack IS-164 

direct access storage IS- 1 54 

disk(ette) unit IS-47 

EXIO interface devices IS-49, IS- 157 

general purpose interface bus IS-238 

host communications IS-49, IS- 159 

I/O devices IS-293 

input/output terminals IS-48, IS-183 

interrupt buffer IS-164 

MFA attachment IS-47, IS-146 

multipartition supervisor IS-52 

overlay area IS-53, IS-63 

partitions IS- 162, IS- 163 

performance volume IS-47 

processor storage IS-162, IS-293 

processor-to- processor IS-233 

programs executing in a partition IS-162 

sensor I/O devices IS-49, IS- 160 

Series/ 1-to-Series/1 IS-240 

size of processor storage IS-44 

SM 10 attachment IS-47, IS-146 

supervisor structure IS-68 

system common data area IS-50 

system configuration IS-42 

system timer features IS-242 

tape units IS-46, IS-181 

TTY-type terminals IS-228 

unmapped storage IS- 163 

user initialization modules IS-62 

virtual terminals IS-236 

2741 terminal IS- 188 

4013 terminal IS-191 



4973/4974 printers IS-195 

4975 printer IS- 197 

4978/4979 display terminals IS-201 

4980 display station IS-205 

5219/5224/5225 printers IS-210 
definition statement format IS-145, IS-293 
describe I/O devices to supervisor IS-42 
determine 

if the IBM-supplied system meets your needs IS-5 
device 

hardware address IS-42 
device-dependent statements IS-293 
devices 

not supported by IBM-supplied system IS-8 

supported by starter system IS-43 

supported by starter system $EDXNUC IS-6 
digital input 

SENSORIO statement IS- 160 
direct access storage, define IS-154 
disk 

converting to Version 5 IS-119 

define IS-47 

supervisor object modules IS-56 
DISK statement 

description IS-47, IS-154 

examples IS- 156 

operands IS-154 

sample statement IS-47 

syntax IS-154 
diskette 

converting to Version 5 IS-1 19 

supervisor object modules IS-56 

unit, define IS-47 
DISKIO module description IS-56 
diskless system 

modules required IS-1 14 

system generation procedures IS-1 13 
DSKINIT2 module description IS-67 
D1 024 module description IS-57 
D49624 module description IS-56 
D4963A module description IS-56 
D4966A module description IS-56 
D4969A module description IS-57 
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EBFLCVT module IS-59 
edit 

considerations IS-95 

job procedure for system generation IS- 1 00 

link-control data set IS-89 

using $FSEDIT IS-89 
edited link-control data set IS-98 
EDXALU module description IS-54 
EDXFLOAT module description IS-59 
EDXINIT module 

description IS-61 
EDXSTART module description IS-54 
EDXSVCX module description IS-53 
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EDXSYS module description IS-53 
EDXTIMER/EDXTIMR2 module descriptions lS-54 
EDXTIO terminal I/O 

module description IS-57 
emulator 

See supervisor 
entry points, supervisor IS-275 
error logging facility 

support IS-55 
estimate portions of supervisor IS-315 
estimate supervisor size IS-42 
estimating storage 

See storage estimating 
excluding link-control statements IS-95 
execute 

program 

verification IS-36, lS-112 
EXIO device support 

defining interface devices IS- 157 

supervisor object module IS-54 
EXIODEV statement IS-49 

description IS- 157 

examples IS- 158 

operands IS-157 

storage requirements IS-291 

syntax IS-157 
EXIOINIT module description IS-67 
EXIOTRC module description IS-54 
external message 

description IS- 106 

entry points IS-275 

module name IS-275 

resolve errors IS-275 
EXTRN statement 

See external message 



floating-point 

support IS-59 
format, definition statement IS-293 
FORTRAN 

storage requirements IS-324 
full message support IS-57 
FULLMSG module IS-57 



general purpose interface bus 

defined by TERMINAL statement IS-238 
storage requirements IS-290 
TERMINAL statement example IS-239 

generate a tailored operating system IS-77 
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hardware 

configuration, matching IS-5 

jumpers IS-243 
Host Communications Facility 

support IS-56 
host communications, define IS- 159 
HOSTCOMM statement 

description IS-49, IS- 159 

example IS- 159 

syntax IS- 159 
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I/O error logging 

software support IS-55 

storage requirements IS-291 
lAMQCB module description IS-55 
IBM-supplied system 

description IS-6 

devices not supported IS-8 

devices supported by $EDXNUC IS-6 

hardware requirements IS- 14 

installation procedure IS- 15 

preparing to install IS- 14 

software features not provided IS-9 

software features provided with $EDXNUC IS- 7 
identify 
INCLUDE statement IS-53 

supervisor object module IS-53 
Indexed Access Method support IS-55 
INITADAP module description IS-61, IS-67 
initial program load 

See I PL (initial program load) 
initialization 

terminals IS-36 

volumes IS-21 
initialization modules 

as overlay segments IS-65 

as resident programs IS-65 

BSCINIT IS-67 

CLOKINIT IS-67 

description IS-65 

DSKINIT2 IS-67 

EXIOINIT IS-67 

INITADAP IS-67 

INITMFA IS-67 

INIT4013 IS-67 

INIT4978 IS-67 

INIT4980 IS-67 

LOADINIT IS-67 

RW4963ID IS-67 

SBIOINIT IS-67 

STORINIT IS-67 

S1S1INIT IS-68 

TAPEINIT IS-68 

TERMINIT IS-68 

TIMRINIT IS-68 
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TPINIT IS-68 
I NITM FA module description IS-61, IS-67 
INIT4013 module description IS-67 
INIT4978 module description IS-61, IS-67 
INIT4980 module description IS-61, IS-67 
install EDX 
disk units 

starter system IS- 14 
diskette units 

starter system IS-14, IS-17 
hardware requirements 

starter system IS-14 
overview IS- 11 
preparation 

starter system IS-14 
procedure 

copy basic utilities IS-25 

copy program preparation modules IS-30 

copy program preparation utilities IS-30 

copy starter system IS-25 

copy support modules IS-25 

copy system support modules IS-28 

exercise utilities and program preparation 

facilities IS-33 
initialize logical volumes IS-21 
I PL starter system from disk IS-27 
IPL the starter system IS- 19 
migrate to Version 4 IS- 1 8 
starter system IS- 1 5 
requirements, starter system 
address of devices IS- 13 
minimum configuration IS- 11 
product diskettes IS- 1 1 
program directory IS- 11 
program products IS-11 
terminals 

starter system IS- 1 5 
interrupt line IS-247 
lOSACCA module description IS-58 
lOSEXIO module description IS-54 
lOSGPIB module description IS-59 
lOSPOOL module description IS-59 
I0SS1 SI module description IS-59 
lOSTERM module description lS-58 
lOSTTY module description IS-58 
lOSVIRT module description IS-59 
IOS2741 module description IS-58 
iOS31 01 module description IS-57 
IOS4013 module description IS-59 
IOS4974 module description IS-57 
IOS4975A module description IS-58 
IOS4979 module description IS-58 
101024 module description IS-61 
IPL (initial program load) 

alternate device IS-14, IS- 15 
message IS-20, IS- 108 
primary device IS-14, IS- 15 
set switch IS- 19 
starter system IS-19 
tailored supervisor IS- 108 



jumpenng 

adapters IS-243 



link control data set 

edit procedure IS-89 

link-edit supervisor object modules IS-104 

sample $LNKCNTL IS-89 

software support IS-89 
LINK statement 

description IS-62 

location of supervisor IS-62 

name of supervisor IS-62 
link-edit 

supervisor object modules IS-104 

verification program IS-35, IS-112 
load 

starter system IS-19 
loading message IS- 18 
LOADINIT module description IS-67 
location of supervisor IS-40, IS-62 
logging device 

alternate IS-37 

primary IS-36 

second alternate IS-37 
logical volume 

initialize 

for starter system IS-21 
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maintain multiple supervisors IS-98, IS-113 
map supervisor across partitions IS- 164 
message ID only support IS-57 
MFA 

See Multifunction Attachment 
migrate to Version 5 

$MIG AID utility IS-126 

$MIGCOPY utility IS- 140 

$MIG RATE utility IS- 139 

$SSI NIT utility IS-126 

overview IS-118 

special considerations IS-119 
minimize supervisor storage requirements IS-65 
minimum configuration IS-11 
MINMSG module description IS-57 
mode switch, set IS-19 
module names, supervisor IS-275 
Multidrop Work Station Attachment (#1250) 

ADAPTER statement example IS- 149 

considerations for attachment of devices IS- 1 83 

defined by ADAPTER statement IS- 146 
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support module IS-61 
Multifunction Attachnnent 

ADAPTER statement example IS- 148 
defined by ADAPTER statement IS-47, IS-146 
random access memory module IS-1 14 
support module IS-61 
multipartition supervisor assignment IS-51, IS-95 
multiple supervisors, maintain IS-98, IS-1 13 
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name of supervisor IS-62 

number of partitions per processor IS-40 

number of programs executing within partition IS-44 
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product diskettes 

copy starter system IS- 15 

required to install, starter system IS- 17 
program 

defining number of programs in a partition IS- 162 
program function (PF) keys 

when using starter system lS-36 
program preparation 

installation IS-30 

product IS-11 
prompting message IS- 18 
PWRAM80 module description IS-55 
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QUEUEIO module description IS-59 
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OPTION NOVERLAY statement 

description IS-51 
overlay 
area 

defining IS-53, IS-63 
description IS-63 
-.vstem- created IS-63 
overview 

installation procedures IS-15 
installation requirements IS-11 
system definition statements IS- 145 
system generation procedures IS-77 



PART statement 

define multipartition supervisor IS-51 

description IS-51 

example IS-52 

in $LNKCNTL data set IS-95 

syntax IS-52 
partition 

assignment 

supervisor IS-51, lS-95 

size IS-40, IS-44, IS- 162 

structure IS-40 
Pascal, storage requirements IS-324 
performance volume IS-47 

defined IS- 155 
PL/ 1, storage requirements IS-324 
primary logging device IS-36 
Printer Attachment - 5200 Series (#5640) 

ADAPTER statement example IS- 148 

considerations for attachment of devices IS-1 83 

defined by ADAPTER Statement IS-146 

support module IS-61 
processor storage 

define structure IS-44, IS- 162 
processor-to- processor, define IS-233 
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reduce supervisor size 

description lS-68 

method 

initialization routines IS-68 
multipartition supervisor IS-68 
reference to terminals, symbolic IS- 185 
Remote Support Link 

include module requirements IS-56 

required support modules IS-58 

TERMINAL definition statement parameters IS-214 

TERMINAL statement examples IS-226 
RLOADER resident loader 

module description IS-55 
RW4963ID module description IS-61, IS-67 



sample system 

description IS-41 
device addresses IS-42 
hardware requirements IS-41 
logical map IS-45 
modified $EDXDEFS data set IS-88 
modified $LNKCNTL data set IS-98 
physical map IS-45 
software requirements IS-41 
system definition statements IS-88 
work sheet 2 IS-71 
worksheets IS-73 
SBAI module description IS-60 
SBAO module description IS-60 
SBCOM module description IS-60 
SBDIDO module description IS-60 
SBIOINIT module description IS-67 
SBPI module description IS-60 
second alternate logging device IS-37 
select software support IS-50 
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sensor-based I/O 

I/O devices 

define IS-49, IS- 160 
storage requirennents IS-291 
support IS-60 
SENSORIO statement IS-49 

description IS- 160 

examples IS- 161 

syntax IS- 160 
Series/1 -to-Series/1 Attachment 

defined by TERMINAL statement IS-240 

storage requirements iS-290 

TERMINAL statement example IS-241 
set mode switch IS- 19 
set up partition structure IS-44 
size of partitions IS- 162 
size of supervisor parts IS-315 
SMIO 

See Multidrop Work Station Attachment (#1250) 
SMIO attachment, define IS- 146 
software features 

not provided by $EDXNUC IS-9 

supported by starter system $EDXNUC IS- 7 
software support, select IS-50, IS-89 
spooling 

storage requirements IS-290 

support IS-59 
starter system 

description IS-6 

devices not supported IS-8 

devices supported by $EDXNUC IS-6 

hardware requirements IS- 14 

installation procedure IS- 15 

preparing to install IS- 14 

software features not provided IS-9 

software features provided with $EDXNUC IS-7 
storage 

across partitions IS-164 

characteristics IS-40 

mapped IS- 162 

requirements 

multiple terminal manager IS-319 
System/370 channel attach IS-319 
5230 data collection IS-319 

unmapped IS-162 
storage estimating 

application program size IS-70, IS-321 

COBOL programs IS-324 

event driven language programs IS-321 

FORTRAN programs IS-324 

Indexed Access Method IS-319 

initialization modules IS-317 

modules outside partition 1 IS-317 

Pascal programs IS-324 

PL/ 1 programs IS-324 

supervisor object modules IS-315 

supervisor size IS-42, IS-69, IS-288 

utility program size IS-70, IS-320 
STORINIT module 

description IS-67 



STORMGR module 

description IS-55 
supervisor 

entry points IS-275 

estimating size IS- 106, IS-288 

location in storage IS-40, IS-62 

module names IS-275 

multipartition IS-51 

name IS-62, IS-109 

object modules IS-53, IS-309 

partition assignment IS-51, IS-95 

select software support IS-50 

size, estimating IS-315 

software support IS-53 

storage estimates IS-315 

storage requirements IS-289 
supervisor modules 

$DBUGNUC IS-54 

$PR0G1 IS-60 

ACCATRC IS-58 

BSCAM IS-60 

BSCX21 IS-60 

CIRCBUFF IS-55 

DISKIO IS-56 

D1024 IS-57 

D49624 IS-56 

D4963A IS-56 

D4966A IS-56 

D4969A IS-57 

EBFLCVT IS-59 

EDXALU IS-54 

EDXFLOAT IS-59 

EDXINIT IS-61 

EDXSTART IS-54 

EDXSVCX IS-53 

EDXSYS IS-53 

EDXTIMER IS-54 

EDXTIMR2 IS-54 

EDXTIO IS-57 

EXIOTRC IS-54 

FULLMSG IS-57 

lAMQCB IS-55 

INITADAP IS-61 

INITMFA IS-61 

INIT4978 IS-61 

INIT4980 IS-61 

lOSACCA IS-58 

lOSEXIO IS-54 

lOSGPIB IS-59 

lOSPOOL IS-59 

I0SS1S1 IS-59 

lOSTERM IS-58 

lOSTTY IS-58 

lOSVIRT IS-59 

IOS2741 IS-58 

IOS3101 IS-57 

IOS4013 IS-59 

IOS4974 IS-57 

IOS4975A IS-58 

IOS4979 IS-58 
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101024 IS-61 

MINMSG IS-57 

PWRAM80 IS-55 

QUEUEIO IS-59 

RLOADER IS-55 

RW4963ID IS-61 

SBAi IS-60 

SBAO IS-60 

SBCOM IS-60 

SBDIDO IS-60 

SBPI IS-60 

STORMGR IS-55 

SWAITM IS-54 

SYSLOG IS-55 

TPCOM IS-56 

TRASCII IS-56 

TRCRSP IS-56 

TREBASC IS-56 

TREBCD IS-56 
SWAITM module description IS-54 
symbolic reference to terminals IS- 185 
SYSGEN 

See system generation 
SYSLOG module descriptions IS-55 
system 

alternate logging device IS-185 

common data area definition IS-50 

definition statements IS-43 

generate a supervisor IS- 77 

initialization support IS-61 

logging device IS-185 

printer IS- 186 

sample statement IS-44 

second alternate system logging device IS- 186 

timer features IS-242 
system generation 

$JOBUTIL procedure file IS-99 

activate system IS-78 

allocate required data sets IS-79 

data set sizes IS-79 

edit system definition statements IS-81 

error conditions IS- 106 

error recovery IS- 109 

execute $JOBUTIL procedure IS-104 

for a diskless system IS- 1 1 3 

procedure IS- 77 

utilities used IS-78 

verify process IS-1 1 1 
system initialization support IS-60 
SYSTEM statement 

description IS-44, IS- 162 

examples IS- 166 

operands IS- 162 

syntax IS- 162 
SI SI INIT module description IS-68 



tailored operating system, generate IS-77 
tape 

define IS-46, IS- 181 
density IS- 181 
identification IS-1 82 
labels IS- 181 
units, define IS- 181 
used in Version 5 conversion IS- 124 
TAPE statement 

description IS-46, IS- 181 
operands IS- 181 
syntax IS- 181 

TAPE statement example IS- 182 
TAPEINIT module description lS-68 
Tektronix 4013 terminal 

defined by TERMINAL statement IS- 191 
support for digital I/O IS-246 
TERMINAL statement example IS- 194 
teletypewriter 

adapter IS-228 
terminal 

connected via digital I/O IS-246 
define IS-48, IS-1 83 
initialization IS-36 
support IS-57, IS- 183 
TERMINAL statement 
coding by device 
ACCA IS-214 
example IS-209 
GPIB IS-238 
PROC IS-233 

Series/ 1-to-Series/1 IS-240 
syntax IS- 205 
TTY IS-228 
virtual terminal IS-236 
2741 IS- 188 
4013 IS- 191 
4973/4974 IS- 195 
4975 IS- 197 
4978/4979 IS-201 
4980 IS- 205 
5219/5224/5225 IS-210 
description IS-48, IS- 183 
device-dependent operands IS- 186 
for ACCA-type terminals IS-214 
for 4975-01 A ASCII printer IS-214 
label description IS-185 
sample statement IS-48 
TERMINIT module description IS-68 
time and date 

format IS- 164 
timer 

features, define IS-242 
support IS-54 
TIMER statement 

description IS-47, IS-242 
storage requirements IS-290 
TIMER statement example IS-242 
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TIMRINIT module description IS-68 
TPCOM module description IS-56 
TPINIT module description IS-68 
translation table support IS-56 
transmission codes IS- 184 
TRASCII module description IS-56 
TRCRSP module description IS-56 
TREBASC module description IS-56 
TREBCD module description IS-56 
TTY-type terminals 

defined by TERMINAL statement IS-228 
TERMINAL statement example IS-232 
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unmapped storage 

define IS- 163 

storage support IS-55 
user-defined 

overlay area IS-53, IS-63 
user-written initialization modules IS-62 
utility program size IS-320 



X.21 circuit switched support 

BSCX21 module description IS-60 



1 



1024 -byte sectors 

storage requirements IS-289 

1250 multidrop work station attachment 
ADAPTER statement example IS- 149 
considerations for attachment of devices IS- 1 83 
defined by ADAPTER statement IS- 146 

1310 multifunction attachment 

attachment with 3101 Display Terminal IS-256 
considerations for attachment of devices IS- 1 83 
defined by ADAPTER statement IS- 146 
description IS-248 

1610 asynchronous communications single line controller 
attachment with 3101 Display Terminal IS-252 
considerations for attachment of devices IS- 1 83 



Version 5 conversion considerations IS- 1 1 8 
virtual terminals 

defined by TERMINAL statement IS-236 

storage requirements IS-290 

TERMINAL statement example IS-237 
volume 

initialize 

starter system installation IS-21 

installation 

starter system sizes IS-21 

required to install EDX IS-21 

size IS-21 
VOLUME statement IS-53 
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2091 asynchronous communications eight line controller 
attachment with 3101 Display Terminal IS-252 
considerations for attachment of devices IS- 1 83 

2092 asynchronous communications four line adapter 
attachment with 3101 Display Terminal IS-252 
considerations for attachment of devices IS-1 83 

2095 feature programmable eight line controller 
attachment with 3101 Display Terminal IS-252 
considerations for attachment of devices IS- 1 83 

2096 feature programmable four line adapter 
attachment with 3101 Display Terminal IS-252 
considerations for attachment of devices IS- 1 83 

2741 Communications Terminal 

defined by TERMINAL statement IS- 188 
storage requirements IS-290 
support module IS-58 
TERMINAL statement example IS-190 



weak external message 

description IS-105, IS-106 
entry points IS-275 
module name IS-275 
resolve errors IS-275 

work sheets, system generation 
work sheet 1 IS-288 
work sheet 2 IS-293 
work sheet 3 IS-309 
work sheet 4 IS-315 

WXTRN statement 

See weak external message 



3101 Display Terminal 

block mode considerations IS-254 

character mode considerations IS-250 

defined by TERMINAL statement IS-214, IS-228 

SEND key IS-258 

setup switch settings 

block mode IS-254 

character mode IS-250 
storage requirements IS-290 

TERMINAL statement examples IS-223, IS-224, IS-225, 
IS-232 



Index IS-343 



Index 



4952 processor IS-40 

4954 processor IS-40 

4955 processor IS-40 

4956 processor IS-40 

4962 Disk 

defined with DISK statement IS- 154 
storage requirements IS- 289 
support module IS-56 

4963 Disk 

defined with DISK statement IS- 154 
storage requirements IS-289 
support module IS-56, IS-61 

4964 Diskette Storage Unit 

defined with DISK statement IS- 154 
storage requirements IS-289 
support module IS-56 

4965 Diskette Storage Unit 

defined with DISK statement IS- 154 
storage requirements IS-289 
support module IS-56, IS-57 

4966 Diskette Magazine Unit 

defined with DISK statement IS- 154 
storage requirements IS-289 
support module IS-56, IS-57 

4967 Disk 

defined with DISK statement IS- 154 
storage requirements IS-289 
support module IS-56 

4968 Tape Unit 

defined with TAPE statement IS- 181 
storage requirements IS-289 
support module IS-57 

4969 Tape Unit 

defined with TAPE statement IS- 181 
storage requirements IS-289 
support module IS-57 

4973 Line Printer 

defined by TERMINAL statement IS-195 

storage requirements IS-289 

support module IS-57 

TERMINAL statement example IS-196 

4974 Matrix Printer 

defined by TERMINAL statement IS-195 
storage requirements IS-289 
support module IS-57 
TERMINAL statement example IS-196 

4975 Printer 

defined by TERMINAL statement IS-197 
local attachment IS-197 
remote attachment IS-197 
storage requirements IS-289 
support module IS-57 
TERMINAL statement example IS-200 
4975-01 A ASCII Printer 

defined by TERMINAL statement IS-215 



support module IS-57, IS-58 
TERMINAL statement examples IS-226 

4978 Display Station 

defined by TERMINAL statement IS-201 
storage requirements IS-289 
support module IS-57, IS-58, IS-61 
TERMINAL statement example IS-204 

4979 Display Station 

defined by TERMINAL statement IS-201 
storage requirements IS-289 
support module IS-57, IS-58, IS-61 
TERMINAL statement example IS-204 

4979 Display Station attachment IS-201 

4980 Display Station 

defined by TERMINAL statement IS-205 
storage requirements IS-289 
support module IS-55, IS-57, IS-58, IS-61 
TERMINAL statement example IS-209 



5219 Printer 

defined by TERMINAL statement IS-210 
storage requirements IS-289 
support module IS-57 
TERMINAL statement example IS-212 

5224 Printer 

defined by TERMINAL statement IS-210 
storage requirements IS-289 
support module IS-57 
TERMINAL statement example IS-212 

5225 Printer 

defined by TERMINAL statement IS-210 

storage requirements IS-289 

support module IS-57 

TERMINAL statement example IS-21 2 
5620 4974 matrix printer attachment 

defined by TERMINAL statement IS-195 
5630 4973 line printer attachment 

defined by TERMINAL statement IS-195 
5640 printer attachment - 5200 series 

ADAPTER statement example IS- 148 

considerations for attachment of devices IS- 1 83 

defined by ADAPTER statement IS- 146 
5719-XS5 

See supervisor 
5719-XX5 

See program preparation 



7850 teletypewriter adapter 

attachment with 3101 Display Terminal IS-251 
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